Comment Command - Xerox DocuPrint 96MX Forms Creation Manual

COMMENT command

Recording comments
Comment nesting
XEROX DOCUPRINT 96/DOCUPRINT 96MX LPS FORMS CREATION GUIDE
It is frequently helpful to include comments in the source statements
to describe certain FDL commands and their functions. These
comments are useful when debugging your program, and can act as
reminders if you, or someone else, modifies the FSL at a later time.
When you use comments, they appear on the source statement only.
They are not printed on your form nor do they affect the execution of
your program.
Enter the word COMMENT, then the text that describes the
command or procedure, followed by a semicolon.
Important: The semicolon must be inserted at the end of the
comment text, otherwise all of the following FDL commands are
considered part of the comment text and are not executed. All
comments up to the first semicolon encountered are ignored by the
FDL compiler.
The format of the comment command is:
COMMENT text;
Asterisks and or line spacing cause the COMMENT to stand out from
the text.
Example:
COMMENT *** DRAW HORIZONTAL LINES ***;
Sample FSL This sample illustrates a COMMENT that identifies the procedure
that is to follow:
COMMENT *** PLACE SECTIONS ***;
DO SECTION RSPNSE AT 0,0;
DO SECTION RSPNSE AT 7,0;
DO SECTION RSPNSE AT 14,0;
/* begins a comment and */ ends a comment.
Example:
/* THIS IS THE START OF A NESTED COMMENT
/* WHEN TWO ENDING COMBINATIONS ARE FOUND */
THE COMMENT IS TERMINATED */
A syntax error results if /* does not begin a comment, and */ does not
end a comment. Each comment beginning (/*) and ending (*/) should
be followed by at least one space character.
FORMS DESCRIPTION LANGUAGE
3-43