Using VPLUS: An Introduction to Forms Design (32209-90004)

8-2
Figure 8-1. Run FORMSPEC
ADD COMMENTS TO PROCESSING SPECIFICATIONS
When you entered the editing statements in Section 4, you added custom
error messages that are displayed by ENTRY in case the edit fails. These
messages are aids to the user to make error correction easier. FORMSPEC
provides another type of message for the forms designer. These are
comments that can be added to any processing specification to describe
the purpose of the specification statement. These comments are
particularly useful for non-editing statements where custom error
messages are not allowed.
Comments must be preceded by a back slash (\). This distinguishes them
from the specification statement itself. When the forms file is
compiled, the comments are retained in the forms file, but they do not
affect execution and, thus, are governed by no syntax rules other than
the initial back slash.
When the Field Menu is displayed, the comment is displayed too. And when
the forms file is listed, the comments are listed with the field
description. They serve as documentation for the forms designer to
describe what the particular statement does and, as such, are
particularly useful if someone other than the initial designer wants to
determine the intent of the associated statement.
Action
To add these statements, you first run FORMSPEC and request the file,