procyberian/emacs
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

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

Browse source 
* lisp/simple.el (eval-expression, eval-expression-print-format):
* lisp/progmodes/elisp-mode.el (eval-last-sexp): Doc fixes.
(Bug#32064)
This commit is contained in:
Eli Zaretskii 2018-07-06 12:31:51 +03:00
parent 6cfc7a7b1b
commit 4abf94fa3b
2 changed files with 9 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

10
lisp/progmodes/elisp-mode.el
View file

@ -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."

8
lisp/simple.el
View file

@ -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,
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