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
[email protected]
http://lists.gnu.org/mailman/listinfo/emacs-devel
