pragma - inline compiler directive

SYNOPSIS

<!-- pragma [name] [value] -->

DESCRIPTION
The pragma directive, unlike any other directive, can appear anywhere in the script, including inside a function. Pragmas typically alter the way code is lexically analyzed, so their features can be applied only to certain code sections if desired. Since they appear in comments, earlier Vortex versions that are not aware of the pragmas will ignore them silently. The pragmas available include:

• strictcomment on|off
  Turn on or off strict comment parsing. With strict comments on, comments must start with ``<!--'', not just ``<!''; thus tags such as ``<!DOCTYPE>'' are directly printable and don't get interpreted as comments. The default is on. Added in version 3.01.986950000 20010410.

• nestcomment on|off
  Turn on or off nesting of comments. With nesting on, comments may be nested. The default is off. Added in version 3.01.986950000 20010410.

EXAMPLE
In this example, nestable comments are turned on. Thus the ``print bio of author'' comment, which is inside a larger comment, nests properly, and the entire inner <SQL> statement is commented out:

<!-- pragma nestcomment on -->
<A NAME=main>
  <SQL "select Title, Author from books
        where Keywords like $query">
    Title: $Title       <!-- print title -->
    Author: $Author     <!-- print author -->
<!-- this section commented out:
    <SQL "select Details from author
          where Author = $Author">
      Bio: $Details     <!-- print bio of author -->
    </SQL>
  -->
  </SQL>
</A>

SEE ALSO
urlcp