emacs-diffs
[Top][All Lists]
Advanced

[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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]