LSE$CLIHELP.HLB  —  DEFINE  LANGUAGE  Qualifiers  /COMMENT
       /COMMENT=(specifier, . . . )

    Specifies the character sequences of comments in the language. The
    specifiers are as follows:

    o  ASSOCIATED_IDENTIFIER=keyword

       Indicates the preferred association of comments to identifier.
       You can specify one of the following values:

       -  NEXT-Indicates that comments should be associated with the
          next identifier.

       -  PREVIOUS-Indicates that comments should be associated with
          the preceding identifier.

    o  BEGIN=list of quoted strings

       END=list of quoted strings

       Defines the character sequences that start and end bracketed
       comments. A bracketed comment begins and ends with explicit
       comment delimiters. (Note that the beginning and ending comment
       delimiters can be the same, but need not be.) The list provided
       with the specifiers BEGIN and END can be any of the following:

       -  A string that is the one open comment sequence for the
          language. You must enclose this in quotes.

       -  A parenthesized list of strings, each one of which can be
          an open comment sequence for the language. You must enclose
          each one in quotes.

       The list accompanying the BEGIN specifier must be consistent
       with the list accompanying the END specifier. If the BEGIN
       specifier lists a string, then the END specifier must also list
       a string.

       Bracketed comments are recognized by the formatting commands
       (see the ALIGN and FILL commands) and placeholder operations
       (see the ERASE PLACEHOLDER command and the /DUPLICATION
       qualifier of the DEFINE PLACEHOLDER command).

    o  TRAILING=list of quoted strings

       Defines the character sequence that introduces line-oriented
       comments. A line-oriented comment begins with a special
       character sequence (consisting of one or more characters)
       and ends at the end of the line. The list provided with the
       TRAILING specifier can be any of the following:

       -  A string that is the one-line comment sequence for the
          language.

       -  A list of strings enclosed in parentheses; each string can
          be a line-comment sequence for the language.

       Line comments are recognized by the formatting commands and
       placeholder operations, just as bracketed comments are.

    o  LINE=list of quoted strings

       Requires that the comment delimiter be the first character that
       is not blank on the line. The LINE specifier is particularly
       useful with block comments, such as the following:

              /*
              ** Here is the inside of a comment
              ** which has LINE="**" specified
              */

    o  FIXED=quoted string, column number

       Used for languages that require that a specific comment
       delimiter be placed in a specific column, such as FIXED=("*",1)
       for COBOL.

    Note that for the specifier you cannot use any character that you
    used in the /PLACEHOLDER delimiter-specification.
Close Help