Whitespace and documentation

Whitespace (spaces, tabs, and newlines) only has meaning to seperate two identifiers or two symbols, which otherwise would be read as a single identifier or symbol.


Comments are read by the parser as a single space, although tagged-comments are stored into a text-literal aspect of whatever variable it is in. The aspect name is the tagged-comment initial identifier prepended by the character '_'

It is an error to use tagged comments if there is no encapsulating variable; if there is more than one variable, the tag is attached to all variables.

the test foo () #:fail_reason:fails randomly:# :

unless (foo()):
  print( "[Function foo() failed. Reason could be: ']"
    // ::foo::_fail_reason
    // "['\n]");