R devel - Dec 2002 - Comments not documented in language reference (PR#2367)

The R Language Definition manual should document comments.  I think
this should go after section 10.1 "The Parsing Process" and before
10.2 "Tokens".  Here's some draft text.

@node Comments, Tokens, The parsing process, Parser
@comment  node-name,  next,  previous,  up
@section Comments

Comments in R are ignored by the parser.  Any text from a \# character
to the end of the line is taken to be a comment.  For example, 

@smallexample
> x <- 1  # This is a comment
@smallexample

>>>>> "Duncan" == Duncan Murdoch
<dmurdoch@pair.com>
>>>>>     on Thu, 12 Dec 2002 15:19:07 +0100 (MET) writes:
    Duncan> The R Language Definition manual should document comments.  I
think
    Duncan> this should go after section 10.1 "The Parsing Process"
and before
    Duncan> 10.2 "Tokens".  

yes, very reasonable -- well spotted!

    Duncan> Here's some draft text.
    Duncan> @node Comments, Tokens, The parsing process, Parser
    Duncan> @comment  node-name,  next,  previous,  up
    Duncan> @section Comments


    Duncan> Comments in R are ignored by the parser.  Any text
    Duncan> from a \# character to the end of the line is taken
    Duncan> to be a comment.  For example,

    Duncan> @smallexample
    >> x <- 1  # This is a comment
    Duncan> @smallexample

this is not quite exact.  "#" only starts a comment when not
inside a string (or a comment already).

You can add it yourself to doc/manual/R-lang.texi, right?
Martin