Commit 4abf94fa authored by Eli Zaretskii's avatar Eli Zaretskii

Clarify and improve doc strings of 'eval-last-sexp' and friends

* lisp/simple.el (eval-expression, eval-expression-print-format):
* lisp/progmodes/elisp-mode.el (eval-last-sexp): Doc fixes.
(Bug#32064)
parent 6cfc7a7b
...@@ -1189,11 +1189,11 @@ current buffer. ...@@ -1189,11 +1189,11 @@ current buffer.
Normally, this function truncates long output according to the Normally, this function truncates long output according to the
value of the variables `eval-expression-print-length' and value of the variables `eval-expression-print-length' and
`eval-expression-print-level'. With a prefix argument of zero, `eval-expression-print-level'. With a prefix argument of zero,
however, there is no such truncation. Such a prefix argument however, there is no such truncation.
also causes integers to be printed in several additional formats Integer values are printed in several formats (decimal, octal,
\(octal, hexadecimal, and character when the prefix argument is and hexadecimal). When the prefix argument is -1 or the value
-1 or the integer is `eval-expression-print-maximum-character' or doesn't exceed `eval-expression-print-maximum-character', an
less). integer value is also printed as a character of that codepoint.
If `eval-expression-debug-on-error' is non-nil, which is the default, If `eval-expression-debug-on-error' is non-nil, which is the default,
this command arranges for all errors to enter the debugger." this command arranges for all errors to enter the debugger."
......
...@@ -1471,9 +1471,9 @@ This affects printing by `eval-expression' (via ...@@ -1471,9 +1471,9 @@ This affects printing by `eval-expression' (via
:version "26.1") :version "26.1")
(defun eval-expression-print-format (value) (defun eval-expression-print-format (value)
"If VALUE in an integer, return a specially formatted string. "If VALUE is an integer, return a specially formatted string.
This string will typically look like \" (#o1, #x1, ?\\C-a)\". This string will typically look like \" (#o1, #x1, ?\\C-a)\".
If VALUE is not an integer, nil is returned. If VALUE is not an integer, return nil.
This function is used by commands like `eval-expression' that This function is used by commands like `eval-expression' that
display the result of expression evaluation." display the result of expression evaluation."
(when (integerp value) (when (integerp value)
...@@ -1534,11 +1534,11 @@ non-nil (interactively, with a prefix argument of zero), however, ...@@ -1534,11 +1534,11 @@ non-nil (interactively, with a prefix argument of zero), however,
there is no such truncation. there is no such truncation.
If the resulting value is an integer, and CHAR-PRINT-LIMIT is If the resulting value is an integer, and CHAR-PRINT-LIMIT is
non-nil (interactively, unless given a positive prefix argument) non-nil (interactively, unless given a non-zero prefix argument)
it will be printed in several additional formats (octal, it will be printed in several additional formats (octal,
hexadecimal, and character). The character format is only used hexadecimal, and character). The character format is only used
if the value is below CHAR-PRINT-LIMIT (interactively, if the if the value is below CHAR-PRINT-LIMIT (interactively, if the
prefix argument is -1 or the value is below prefix argument is -1 or the value doesn't exceed
`eval-expression-print-maximum-character'). `eval-expression-print-maximum-character').
Runs the hook `eval-expression-minibuffer-setup-hook' on entering the Runs the hook `eval-expression-minibuffer-setup-hook' on entering the
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment