[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-26 4abf94f: Clarify and improve doc strings of 'eval
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] emacs-26 4abf94f: Clarify and improve doc strings of 'eval-last-sexp' and friends |
Date: |
Fri, 6 Jul 2018 05:32:55 -0400 (EDT) |
branch: emacs-26
commit 4abf94fa3bfc9d03423c80b7ceab82905a4e3baa
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>
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)
---
lisp/progmodes/elisp-mode.el | 10 +++++-----
lisp/simple.el | 8 ++++----
2 files changed, 9 insertions(+), 9 deletions(-)
diff --git a/lisp/progmodes/elisp-mode.el b/lisp/progmodes/elisp-mode.el
index 8fe6ef0..91d05ce 100644
--- a/lisp/progmodes/elisp-mode.el
+++ b/lisp/progmodes/elisp-mode.el
@@ -1189,11 +1189,11 @@ current buffer.
Normally, this function truncates long output according to the
value of the variables `eval-expression-print-length' and
`eval-expression-print-level'. With a prefix argument of zero,
-however, there is no such truncation. Such a prefix argument
-also causes integers to be printed in several additional formats
-\(octal, hexadecimal, and character when the prefix argument is
--1 or the integer is `eval-expression-print-maximum-character' or
-less).
+however, there is no such truncation.
+Integer values are printed in several formats (decimal, octal,
+and hexadecimal). When the prefix argument is -1 or the value
+doesn't exceed `eval-expression-print-maximum-character', an
+integer value is also printed as a character of that codepoint.
If `eval-expression-debug-on-error' is non-nil, which is the default,
this command arranges for all errors to enter the debugger."
diff --git a/lisp/simple.el b/lisp/simple.el
index cbad751..8b18346 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -1471,9 +1471,9 @@ This affects printing by `eval-expression' (via
:version "26.1")
(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)\".
-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
display the result of expression evaluation."
(when (integerp value)
@@ -1534,11 +1534,11 @@ non-nil (interactively, with a prefix argument of
zero), however,
there is no such truncation.
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,
hexadecimal, and character). The character format is only used
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').
Runs the hook `eval-expression-minibuffer-setup-hook' on entering the
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] emacs-26 4abf94f: Clarify and improve doc strings of 'eval-last-sexp' and friends,
Eli Zaretskii <=