[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Update to programs.texi for CC Mode 5.30, and incidental amendments.
From: |
Richard Stallman |
Subject: |
Re: Update to programs.texi for CC Mode 5.30, and incidental amendments. |
Date: |
Mon, 17 May 2004 07:04:22 -0400 |
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.