Comment removes Line Break
Similar to how a trailing “\” removes the following line break, a leading comment will remove the previous line break.
The first line ends in a backslash\
Second line
Result:
The first line ends in a backslashSecond line
The first line
[!----]Second line starts with a comment
Result:
The first lineSecond line starts with a comment
Nested comments?
Can you comment out a a section of code that itself may contain comments?
Standard Method
The standard method doesn't work. The starting comment is ended by the end of first nested comment.
Code before commented section
[!--
A section of ``code'' containing @@a@@ [!-- nested --] comment
--]
Code after commented section
Result:
Code before commented section comment
—]
Code after commented section
Extended Method
To comment out a code section that may contain nested comments use
- "[!--", "[[code]]" as a comment start and
- "[[/code]]", "--]" as end comment
Code before commented section
[!--
[[code]]
A section of ``code'' containing @@a@@ [!-- nested --] comment
[[/code]]
--]
Code after commented section
Result:
Code before commented section
Code after commented section