Many of your suggested changes are good; I will comment on the ones that I don't plan to use.
! In Lisp, the symbol @[EMAIL PROTECTED] has three separate meanings: it is a symbol with the name @samp{nil}; it is the logical truth value We don't write @dfn around @code. @cindex documentation notation + @cindex notation, evaluation + @cindex notation, documentation Having two index entries in the same place that start with the same word is redundant; it would be better to add @cindex notation Examples in this manual indicate printed text with @[EMAIL PROTECTED], irrespective of where that text goes. The value returned by ! evaluating the form (here @code{bar}) follows on a separate line with ! @[EMAIL PROTECTED] @example @group --- 264,271 ---- Examples in this manual indicate printed text with @[EMAIL PROTECTED], irrespective of where that text goes. The value returned by ! evaluating the form (in the example below: @code{bar}) follows on a ! separate line with @[EMAIL PROTECTED] Using "here" is conventional, so it is good enough. @defvar emacs-major-version The major version number of Emacs, as an integer. For Emacs version ! 20.3, the value is @code{20}. We don't write @code around values that are numbers. It looks better not to do so. _______________________________________________ Emacs-devel mailing list Emacs-devel@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-devel