Change index of ";" to better reflect it's usage (Bug#31623)

* doc/lispref/objects.texi (Comments): "; for commenting" fits better
with the following text about how a semicolon begins a comment.  Also
mention that only unescaped semicolons start a comment.
This commit is contained in:
Noam Postavsky 2018-06-20 08:40:51 -04:00
parent d289e7e38a
commit 40e1db8ccd

View file

@ -109,15 +109,15 @@ not be evaluated later. @xref{Input Functions}, for a description of
@node Comments @node Comments
@section Comments @section Comments
@cindex comments @cindex comments
@cindex @samp{;} in comment @cindex @samp{;} for commenting
A @dfn{comment} is text that is written in a program only for the sake A @dfn{comment} is text that is written in a program only for the
of humans that read the program, and that has no effect on the meaning sake of humans that read the program, and that has no effect on the
of the program. In Lisp, a semicolon (@samp{;}) starts a comment if it meaning of the program. In Lisp, an unescaped semicolon (@samp{;})
is not within a string or character constant. The comment continues to starts a comment if it is not within a string or character constant.
the end of line. The Lisp reader discards comments; they do not become The comment continues to the end of line. The Lisp reader discards
part of the Lisp objects which represent the program within the Lisp comments; they do not become part of the Lisp objects which represent
system. the program within the Lisp system.
The @samp{#@@@var{count}} construct, which skips the next @var{count} The @samp{#@@@var{count}} construct, which skips the next @var{count}
characters, is useful for program-generated comments containing binary characters, is useful for program-generated comments containing binary