[Rd] Comments not documented in language reference (PR#2367)

maechler@stat.math.ethz.ch maechler@stat.math.ethz.ch
Thu Dec 12 18:20:03 2002

>>>>> "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?