Keyboard shortcuts

Press โ† or โ†’ to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Opaque Line Comment

An entire line treated as an opaque comment, i.e. ignored in the final output and used solely to provide information to other contributors to the project.

Syntax

Any number of Unicode characters following the double slashes //, optionally preceded by a valid comment tag.

Overview

NotationConceptual ASTPaper Output
//TแถœแตŸ ๐‘†ร—๐‘Comment(๐‘†ร—๐‘, TแตฅแตŸ, Line)โ€”
  • ๐‘† = any sign (Unicode character) โˆ‰ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • ๐‘ = number of characters (represented by char or digits).
  • TแถœแตŸ = optional comment tag.
  • TแตฅแตŸ = validated optional comment tag.

Examples

NotationPaper Output
//abc

EpiDoc Outputs

NotationEpiDoc (XML)
//abc
<ab>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
//abc
Comment(Line, None, "abc")