Clarify comment positioning

[SpecificProtagonist]

The spec says comments are enclosed in parenthesis, but doesn't state where they can be used. For example, can they be placed inside of keywords (similar to how 'f''als''''e is a valid equivalent of false)?

I'd prefer if either comments can be used as whitespace, or if they can be used in between two whitespaces.

[dylanbeattie]

You're right - the spec is unclear here.

In Satriani, comments are handled by the parser, so they can occur between language tokens, but not inside them.

Shout(comment)my name is valid, but Sh(comment)out my name` is not.

The spec needs updating to reflect this; I'll put it on my list :)