•  Back 
  •  Main 
  •  Index 
  •  Tree View 
  •  Cross references 
  •  Help 
  •  Show info about hypertext 
  •  View a new file 
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-FileIn the last menu, entitled Sets, certain parameters can be set. These
parameters are described below.

The G3WAIT parameter determines whether or not, during compilation and
linking, a key is to be pressed before a file is opened. Such files could be
for example, the program being compiled, the object file, GFA3BLIB.NDX,
GFA3BLIB and the PRG file.

The purpose of this option is to allow you to change the disk before pressing
the key to continue. This is essential if you have only one disk drive, and the
necessary files reside on more than one disk.

After selecting this option, all the parameters in the Sets menu are displayed
on the screen. From this display you can see whether G3WAIT has been turned on
or off.

You can also see from this display whether the next parameter on the menu,
G3MOVE, is on or off. If G3MOVE is on, G3MOVE=ON is displayed on the
screen.

Enabling G3MOVE directs the Compiler to manage the available storage space
economically during compilation. To begin the task the source code is loaded,
and compilation started. The compiled code is also held in store until it is
moved out.

In the case where you have a very large program and only a small amount of free
space, the source code and object program together may be too large to fit
completely in memory.

By activating G3MOVE, as each procedure is compiled the source code is moved
out of memory. Naturally, this packing of memory during compilation is time
consuming, so G3MOVE should only be enabled when necessary.

If you only select the entry G3OBJ, you can change the default name of
the object file (normally TEST.O). Similarly, using G3PRG you can
change the default name of the compiled and linked object program (normally
TEST.PRG).

G3LIB enables you to change the name of the library normally called
GFA3BLIB. These options can, of course, be used not only for naming the
individual files, but also for establishing the path to the files.

The parameters can also be called by typing the letter following G3.

PRG=GFA, also selected with F2 key. In this mode the file name
given to the compiled code is derived from the .GFA file (rather than be called
TEST.PRG). By selecting F2 (or by setting auto& in the MENU.PRG to 1), a GFA
file can be quickly selected and compiled with the sequence:

    F2
    CTRL S (entering name in File Select box)
    F10

C Object, also selected with C key. With this option you can
enter the names of the object files to be linked to the compiled code (Turbo C,
DRDigital Research
 C, or assembler).

Therefore:

    W or w  for  G3WAIT
    M or m  for  G3MOVE
    O or o  for  G3OBJ
    P or p  for  G3PRG
    L or l  for  G3LIB
    F2      for  PRG=GFA
    C       for  C Object

Pressing the Help key clears the screen and displays the current state
of the Sets menu parameter entries.

Pressing the Undo key clears the screen but does not display the
parameter values.