Macro Comments

You may add comments to a macro definition, in order to document what it is doing, or to temporarily disable certain commands. A comment is any text that appears after a semicolon, for the rest of that line. If a line begins with a semicolon, the whole line is regarded as a comment:

    ;Set Left Stream 0 Tone Freq to 1000 Hz:
    L.0.ToneFreq=1000 ;This is the line that does it.

You can disable multiple lines using an extended comment. Begin an extended comment with a line starting with a semicolon, immediately followed by one or more '+' signs. After the last macro line to be disabled, enter a line starting with a semicolon followed by one or more '-' signs:

    
    A=L.0.ToneFreq
    B=R.0.ToneFreq
    ;+++++ Extended comment starts
    C=sqrt(A^2 + B^2)
    L.1.ToneFreq=C
    L.0.Level=50
    L.1.Level=50
    ;----- Extended comment ends
    ...
    ...
    

This is often simpler than inserting semicolons in front of every line to be disabled. It is especially handy during development, since you can easily re-enable the lines by inserting a space after the starting semicolon. That converts the starting line into an ordinary single-line comment, so the following lines run normally. (You don't need to do anything with the ending line; it's a valid single-line comment as-is.)

Note that you may not comment out continued lines (those following a line ending with an underscore) unless you comment out the initial underscore line as well.