From: Drew Adams <drew.adams@oracle.com>
To: 32064@debbugs.gnu.org
Subject: bug#32064: 26; doc string of `eval-last-sexp'
Date: Thu, 5 Jul 2018 13:15:16 -0700 (PDT) [thread overview]
Message-ID: <0d7bb132-057e-431e-a5fa-86e15b99879a@default> (raw)
The doc string was messed up a bit in Emacs 26, apparently for the fix
of bug #4118.
From this, which makes sense:
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).
The text was changed to this, which does not make sense at all:
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).
Both old and new say that with a prefix arg of ZERO ("such a prefix
argument") the behavior is to do both of these things:
1. Do not truncate.
2. Print in additional formats.
That's fine. But the Emacs 26+ version also says that with a ZERO prefix
arg ("such a prefix argument"), if the prefix arg is ALSO -1
(impossible) or if "the integer" (what integer?) is less than or equal
to the value of `eval-expression-print-maximum-character', the
additional formats include "character".
A character is not a format, so it's unclear what printing in format
"character" means.
But the main problem with this is that it makes us try to understand a
prefix arg that is BOTH zero and -1, and it leaves us wondering what
"the integer" is that is tested against
`eval-expression-print-maximum-character' when the prefix arg is zero.
If "the integer" is just the numeric prefix arg then the <=
`eval-expression-print-maximum-character' could be clear - but there
should be no connection with the value being zero ("such a prefix arg").
Just say: If zero then no truncation. If <= `eval...' then ___
(whatever is meant by "character format" printing).
In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32)
of 2018-05-30
Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
`configure --without-dbus --host=x86_64-w64-mingw32
--without-compress-install 'CFLAGS=-O2 -static -g3''
next reply other threads:[~2018-07-05 20:15 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-07-05 20:15 Drew Adams [this message]
2018-07-05 21:56 ` bug#32064: 26; doc string of `eval-last-sexp' Drew Adams
2018-07-06 0:23 ` Noam Postavsky
2018-07-06 9:39 ` Eli Zaretskii
2018-07-06 11:47 ` Noam Postavsky
2018-07-06 17:55 ` Drew Adams
2018-07-06 9:37 ` Eli Zaretskii
2018-07-06 9:34 ` Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=0d7bb132-057e-431e-a5fa-86e15b99879a@default \
--to=drew.adams@oracle.com \
--cc=32064@debbugs.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).