[Emacs-diffs] Changes to emacs/lispref/commands.texi,v

[Richard M. Stallman]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Richard M. Stallman <rms>       06/06/16 15:18:03

Index: commands.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/commands.texi,v
retrieving revision 1.82
retrieving revision 1.83
diff -u -b -r1.82 -r1.83
--- commands.texi       13 Jun 2006 22:18:38 -0000      1.82
+++ commands.texi       16 Jun 2006 15:18:03 -0000      1.83
@@ -233,6 +233,20 @@
  (let ((string (read-string "Foo: " nil 'my-history)))
    (list (region-beginning) (region-end) string)))
 @end smallexample
+
address@hidden:} the argument values should not include any data
+types that can't be printed and then read.  Some facilities save
address@hidden in a file to be read in the subsequent
+sessions; if a command's arguments contain a data type that prints
+using @samp{#<@dots{}>} syntax, those facilities won't work.
+
+There are, however, a few exceptions: it is ok to use a limited set of
+expressions such as @code{(point)}, @code{(mark)},
address@hidden(region-beginning)}, and @code{(region-end)}, because Emacs
+recognizes them specially and puts the expression (rather than its
+value) into the command history.  To see whether the expression you
+wrote is one of these exceptions, run the command, then examine
address@hidden(car command-history)}.
 @end itemize
 
 @cindex examining the @code{interactive} form