When FunnelWeb encounters the @! sequence during its left to right scan of the
line, it throws away the rest of the line (including the EOL) without analysing it
further. Comments can appear in any line except "
", and "
FunnelWeb comments can be used to insert comments into your input file that
will neither appear in the product files nor in the documentation file, but will be
solely for the benefit of those reading and editing the input file directly.
@! I have used a quick macro for this definition
@! as it will be used often.
Because comments are defined to include the end of line marker, care must be
taken when they are being added or removed within the text of macro bodies.
For example the text fragment
will expand to
This problem really has no solution; if FunnelWeb comments were defined to
omit the end of line marker, the expanded text would contain trailing blanks! As
it is, FunnelWeb comments are designed to support single line comments which
can be inserted and removed as a line without causing trouble. For example:
@! Print out a[0..MAXVAL 1].
If you want a comment construct that does not enclose the end of line marker,
combine the insert end of line construct @+ with the comment construct @! as
FunnelWeb comments should really only be used to comment the FunnelWeb
http://www.ross.net/funnelweb/reference/scanner_comments.html (1 of 2) [3/3/2000 10:47:27 PM]