Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- The GNU Assembler Preprocessor - <b>special syntactic markers</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Special syntactic markers
-------------------------

   GASP recognizes a few special markers: to delimit comments, to
continue a statement on the next line, to separate symbols from other
characters, and to copy text to the output literally.  (One other
special marker, `\@', works only within macro definitions; *note
Defining your own directives: Macros..)

   The trailing part of any GASP source line may be a "comment".  A
comment begins with the first unquoted comment character (`!' by
default), or an escaped or doubled comment character (`\!' or `!!' by
default), and extends to the end of a line.  You can specify what
comment character to use with the `-c' option (Command Line
Options: Invoking GASP.  The two kinds of comment markers lead to
slightly different treatment:

`!'
     A single, un-escaped comment character generates an assembly
     comment in the GASP output.  GASP evaluates any preprocessor
     variables (macro arguments, or variables defined with `.ASSIGNA' or
     `.ASSIGNC') present.  For example, a macro that begins like this

                  .MACRO  SUM FROM=0, TO=9
                  ! \FROM \TO

     issues as the first line of output a comment that records the
     values you used to call the macro.

`\!'
`!!'
     Either an escaped comment character, or a double comment character,
     marks a GASP source comment.  GASP does not copy such comments to
     the assembly output.

   To *continue a statement* on the next line of the file, begin the
second line with the character `+'.

   Occasionally you may want to prevent GASP from preprocessing some
particular bit of text.  To *copy literally* from the GASP source to
its output, place `\(' before the string to copy, and `)' at the end.
For example, write `\(\!)' if you need the characters `\!' in your
assembly output.

   To *separate a preprocessor variable* from text to appear
immediately after its value, write a single quote (`'').  For example,
`.SDATA "\P'1"' writes a string built by concatenating the value of `P'
and the digit `1'.  (You cannot achieve this by writing just `\P1',
since `P1' is itself a valid name for a preprocessor variable.)


See Also: Invoking GASP

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson