Re: Update to programs.texi for CC Mode 5.30, and incidental amendments.

[Richard Stallman]

I'd prefer this way:

    @vindex comment-multi-line
      The variable @code{comment-multi-line} controls how @kbd{C-M-j}
    (@code{indent-new-comment-line}) behaves when used inside a comment.
    Specifically, when @code{comment-multi-line} is @code{nil} (the
    default value), the command inserts a comment terminator, begins a new
    line, and finally inserts a comment starter.  Otherwise it does
    not insert the terminator and starter, so it effectively
    continues the current comment across multiple lines.  In languages
    where multi-line comments work, the choice of value for this
    variable is a matter of taste.

To use @dfn here is a mistake because the text is not written so as to
define the concepts of "comment starter" and "comment terminator".
The first actual reference to these things is above, where the
variables comment-start and comment-end are defined.  Perhaps that
text ought to introduce and explain the terms "comment starter" and
"comment terminator", using @dfn.