Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileThe compiler and linker may be controlled not only by the Shell, but also by a
DOS shell (command line interpreter). This section describes the use of a DOS
shell or similar interface.

The compiler parameters can be passed in the same form as they appear in the
shells screen display, i.e.

    gfa_bcom name S& %3

Much the same applies to the linker parameters. Linking with generation of a
symbol table is achieved by

    gl -s

To include a file named c_tst,

    gl c_tst

may be entered.

In this example, test.o, c_tst.o and gfa3blib are linked. The # character in
the parameter list prevents the file test.o being linked.

The line

    gl # c c_tst

would link the files c.o, c_tst.o and gfa3blib, but not test.o. In order to use
a library other than gfa3blib, you can enter its name prefixed with a plus
sign. Thus

    gl +new_lib

ensures that test.o and new_lib are linked. The linker considers all parameters
which are not prefixed by a plus sign and are not -s or # as the names of
object files to be linked.

Memo: These do not work quite right from the command line:
      $I+  !only works if it is the very first command
      $B+  !always fails

      Input parameters are as follows:
        Compiler:
          via command line: *.GFA source, $commands
          via environment variables: G3OBJ=, G3WAIT=, G3MOVE=

        Linker:
          via command line: #, *.o, +library, -s, -t
          via environment variables: G3OBJ=, G3PRG=, G3LIB=, G3WAIT=