A graynote terminal comment

comment

Use the comment syntax to place a note at the end of a basic phrase, terminating all BLUE-PHRASE processing for that line.

Syntax

A comment begins with the graymark delimiter, which is two consecutive forward-slashes //. Everything after the delimiter is a comment, and is not emitted to the final document.

Comments may be signed by an author by using signature syntax, which is a full-stop followed by a person's name. Spaces are not allowed in a signature. The signature is optional, but when used, it must be placed at the start of the comment.

// .signature The comment itself
Comment syntax

Comments may only be used at the end of basic phrases. They are not allowed to be embedded within term-marks (use remarks instead).

When a URL appears in a manuscript with an http:// or https:// prefix, it is recognized as a URL and not a comment.

When an author writes a terminal comment, there is often some whitespace between the last character of the subject matter and the graymark delimiter at the start of the comment. Those whitespace characters are not emitted.

The comment syntax is a convenient way to temporarily hide an unfinished paragraph, or a paragraph that is pending deletion.

Examples

Here is what a comment looks like within the body of a manuscript.

// .jp The following URL's double-slash isn't treated as a comment:

This URL is https://blue-phrase/syntax/notes/comment.blue // OK
Sample comment syntax

syntax > notes > commentA graynote terminal comment

Q