Re: [PATCH] intro.texi

[Richard M. Stallman]

Many of your suggested changes are good; I will comment on the ones
that I don't plan to use.

    ! In Lisp, the symbol @address@hidden 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 @address@hidden,
    irrespective of where that text goes. The value returned by
    ! evaluating the form (here @code{bar}) follows on a separate line with
    ! @address@hidden

    @example
    @group
    --- 264,271 ----

    Examples in this manual indicate printed text with @address@hidden,
    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 @address@hidden

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.