October 1, 1979 COMMAND MACROS CREATION
MACROS -- $C
(6) A file (macfile) set up to store all format code macro
definitions is retrieved. The next two lines locate the
new end of the format macros delimiter, and the new macro
defined in line four is inserted.
11.2.1.3 &COMMENT _________________
An easy way to optionally monitor progress through a macro or
to document what a macro does, is by including this function on a
command line:
&C'<comments>'
literal <comments>...the _______ text to be typed at the terminal (i.e.,
No no parameter substitution will occur). __
apostrophes ___________ ("'") are allowed in <comments>.
Notes _____
• The MCOMMENT command controls when these "macro comments" will
be typed.
• For clear internal documentation of a Command Macro it is often
desirable to include a comment on the end of a command line.
To make sure that intervening blanks between the end of the
command and the &C'<comments>' are not included in the command
line the FRESS command seperator (">") should be used (see
example in the section above).
• When the Display Mode is to be temporarily overridden (see
Section 2.3) on lines in which there are <comments>, the
"&C'<comments'" must immediately follow the period or modifier
no intervening blanks (if present) with _____________________.
FRESS Resource Manual Release 9.1 FRESS RSection 7.2 -- 253
MACROS -- $C
(6) A file (macfile) set up to store all format code macro
definitions is retrieved. The next two lines locate the
new end of the format macros delimiter, and the new macro
defined in line four is inserted.
11.2.1.3 &COMMENT _________________
An easy way to optionally monitor progress through a macro or
to document what a macro does, is by including this function on a
command line:
&C'<comments>'
literal <comments>...the _______ text to be typed at the terminal (i.e.,
No no parameter substitution will occur). __
apostrophes ___________ ("'") are allowed in <comments>.
Notes _____
• The MCOMMENT command controls when these "macro comments" will
be typed.
• For clear internal documentation of a Command Macro it is often
desirable to include a comment on the end of a command line.
To make sure that intervening blanks between the end of the
command and the &C'<comments>' are not included in the command
line the FRESS command seperator (">") should be used (see
example in the section above).
• When the Display Mode is to be temporarily overridden (see
Section 2.3) on lines in which there are <comments>, the
"&C'<comments'" must immediately follow the period or modifier
no intervening blanks (if present) with _____________________.
FRESS Resource Manual Release 9.1 FRESS RSection 7.2 -- 253
