From 4abf94fa3bfc9d03423c80b7ceab82905a4e3baa Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 6 Jul 2018 12:31:51 +0300 Subject: [PATCH] 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 8fe6ef0550b..91d05ce6983 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 cbad75193a4..8b183469f8a 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 -- 2.39.2