The simplest way to use GASP is to run it as a filter and assemble its output. In Unix and its ilk, you can do this, for example:
$ gasp prog.asm | as -o prog.o
Naturally, there are also a few command-line options to allow you to request variations on this basic theme. Here is the full set of possibilities for the GASP command line.
gasp [ -a | --alternate ] [ -c char | --commentchar char ] [ -d | --debug ] [ -h | --help ] [ -M | --mri ] [ -o outfile | --output outfile ] [ -p | --print ] [ -s | --copysource ] [ -u | --unreasonable ] [ -v | --version ] infile ...
infile ...
Mark the end of each input file with the preprocessor command
.END
. See Other Commands.
-a
--alternate
-c 'char'
--commentchar 'char'
!
'. For example, to use a semicolon as the comment character,
specify `-c ';'
' on the GASP command line. Since
assembler command characters often have special significance to command
shells, it is a good idea to quote or escape char when you specify
a comment character.
For the sake of simplicity, all examples in this manual use the default
comment character `!
'.
-d
--debug
strings size s : n
GASP displays these statistics on the standard error stream, when done preprocessing.
-h
--help
-M
--mri
ASM68K
assembler.
-o outfile
--output outfile
-o
' option, GASP writes its output on the standard output
stream.
-p
--print
-s
' to copy source lines to its output. With `-s -p
', GASP displays the line number of each source line copied
(immediately after the comment character at the beginning of the line).
-s
--copysource
!
' by default) at
the beginning of each source line it copies, so that you can use this
option and still assemble the result.
-u
--unreasonable
-v
--version
Packaging copyright © 1988-2000 OAR Corporation Context copyright by each document's author. See Free Software Foundation for information.