[Emacs-diffs] trunk r116127: * doc/emacs/building.texi (Lisp Eval): Update prefix argument behavior

[Glenn Morris]

------------------------------------------------------------
revno: 116127
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Thu 2014-01-23 00:27:44 -0800
message:
  * doc/emacs/building.texi (Lisp Eval): Update prefix argument behavior
  of eval-expression, eval-last-sexp.
  
  * etc/NEWS: Related edit.
modified:
  doc/emacs/ChangeLog            changelog-20091113204419-o5vbwnq5f7feedwu-6227
  doc/emacs/building.texi        
building.texi-20091113204419-o5vbwnq5f7feedwu-6235
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2014-01-21 08:49:46 +0000
+++ b/doc/emacs/ChangeLog       2014-01-23 08:27:44 +0000
@@ -1,3 +1,8 @@
+2014-01-23  Glenn Morris  <address@hidden>
+
+       * building.texi (Lisp Eval): Update prefix argument behavior
+       of eval-expression, eval-last-sexp.
+
 2014-01-17  Bastien Guerry  <address@hidden>
 
        * building.texi (Commands of GUD): Fix keybinding for `gud-break'.

=== modified file 'doc/emacs/building.texi'
--- a/doc/emacs/building.texi   2014-01-17 12:43:51 +0000
+++ b/doc/emacs/building.texi   2014-01-23 08:27:44 +0000
@@ -1476,13 +1476,17 @@
   The command @kbd{C-x C-e} (@code{eval-last-sexp}) evaluates the
 Emacs Lisp expression preceding point in the buffer, and displays the
 value in the echo area.  When the result of an evaluation is an
-integer, you can type @kbd{C-x C-e} a second time to display the value
-of the integer result in additional formats (octal, hexadecimal, and
-character).
+integer, it is displayed together with the value in other formats
+(octal, hexadecimal, and character).
 
   If @kbd{M-:} or @kbd{C-x C-e} is given a prefix argument, it inserts
 the value into the current buffer at point, rather than displaying it
-in the echo area.  The argument's value does not matter.
+in the echo area.  If the prefix argument is zero, any integer output
+is inserted together with its value in other formats (octal,
+hexadecimal, and character).  Such a prefix argument also prevents
+abbreviation of the output according to the variables
address@hidden and @code{eval-expression-print-length}
+(see below).
 
 @kindex C-M-x @r{(Emacs Lisp mode)}
 @findex eval-defun
@@ -1516,9 +1520,11 @@
   The options @code{eval-expression-print-level} and
 @code{eval-expression-print-length} control the maximum depth and
 length of lists to print in the result of the evaluation commands
-before abbreviating them.  @code{eval-expression-debug-on-error}
-controls whether evaluation errors invoke the debugger when these
-commands are used; its default is @code{t}.
+before abbreviating them.  Supplying a zero prefix argument to
address@hidden or @code{eval-last-sexp} causes lists to be
+printed in full.  @code{eval-expression-debug-on-error} controls
+whether evaluation errors invoke the debugger when these commands are
+used; its default is @code{t}.
 
 @node Lisp Interaction
 @section Lisp Interaction Buffers

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2014-01-23 02:38:18 +0000
+++ b/etc/NEWS  2014-01-23 08:27:44 +0000
@@ -214,12 +214,13 @@
 *** `eval-defun' on an already defined defcustom calls the :set function,
 if there is one.
 
++++
 *** The commands `eval-expression' (`M-:'), `eval-last-sexp' (`C-x C-e'),
-and `eval-print-last-sexp' (`C-j') can take a zero prefix argument.
-This disables truncation of lists in the output, equivalent to
-setting `(eval-expression-)print-length' and `(eval-expression-)print-limit'
-to nil.  Additionally, it causes integers to be printed in multiple
-formats (octal, hexadecimal, and character).
+and `eval-print-last-sexp' (`C-j' in Lisp Interaction mode) can take a
+zero prefix argument.  This disables truncation of lists in the output,
+equivalent to setting `(eval-expression-)print-length' and
+`(eval-expression-)print-limit' to nil.  Additionally, it causes integers
+to be printed in other formats (octal, hexadecimal, and character).
 
 ---
 ** `write-region-inhibit-fsync' now defaults to t in batch mode.