From: Joseph Turner <joseph@breatheoutbreathe.in>
Date: Sat, 9 Nov 2024 19:15:25 +0000 (-0800)
Subject: * lisp/subr.el (read-number): Document collision with 'format-prompt'.
X-Git-Tag: archive/raspbian/1%30.1+1-3+rpi1^2~2^2~20^2~271
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=c29c54410ea889bafc1bb4a29664827bc893b7d4;p=emacs.git

* lisp/subr.el (read-number): Document collision with 'format-prompt'.
---

diff --git a/lisp/subr.el b/lisp/subr.el
index 465795c7555..2152f16ba95 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -3419,9 +3419,10 @@ with Emacs.  Do not call it directly in your own packages."
 (defun read-number (prompt &optional default hist)
   "Read a numeric value in the minibuffer, prompting with PROMPT.
 DEFAULT specifies a default value to return if the user just types RET.
-The value of DEFAULT is inserted into PROMPT.
-HIST specifies a history list variable.  See `read-from-minibuffer'
-for details of the HIST argument.
+For historical reasons, the value of DEFAULT is always inserted into
+PROMPT, so it's recommended to use `format' instead of `format-prompt'
+to generate PROMPT.  HIST specifies a history list variable.  See
+`read-from-minibuffer' for details of the HIST argument.
 
 This function is used by the `interactive' code letter \"n\"."
   (let ((n nil)