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

(cherry picked from commit c29c54410ea889bafc1bb4a29664827bc893b7d4)

diff --git a/lisp/subr.el b/lisp/subr.el
index f70eaac5b5f8a468304d2909a42c7839e73ff636..051faa862ca42b5bb7b2bd79875e2014b563233b 100644 (file)
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -3434,9 +3434,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)