•  Back 
  •  Main 
  •  Index 
  •  Tree View 
  •  Cross references 
  •  STG Help 
  •  Show info about hypertext 
  •  View a new file 
Topic       : GFA-Basic Editor
Author      : Lonny Pursell
Version     : GBE.HYP v3.74 (12/31/2023)
Subject     : Programming/Documentation
Nodes       : 171
Index Size  : 4296
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Default
@help       : STG Help
@options    : +g -i -s +z
@width      : 75
@hostname   : THING   
@hostname   : STRNGSRV
@hostname   : HIGHWIRE
@hostname   : CAB     
View Ref-FileThis dialog is for setting all the paths to the various external utilities
needed by the editor.

Hypertext file:
File name of a help file in hypertext format.  This is not a path.
Requires the use of ST-Guide or compatible viewer.
ST-Guide must be installed correctly for this to work.
Copy the file you selected to where ST-Guide expects to find them.

Assembler file:
File name of the assembler called for the INLINE or #ASM commands.
All output from the assembler will go to the console.
The correct version of Devpac is pre-installed based on the CPU cookie.

Include path:
If an included file is not in the project path, then this path is checked.
Path where all common include files are located.
See meta command #INC for more information.

Temp path:
Path to a temp directory.
This can be anywhere you like so long as it has enough free space.
Some functions require writing temp files.
The use of a ramdisk is quite ok for this purpose.
MiNT users can use 'u:\ram\' (built in ram-disk).

Compiler/Linker set:
Selects which set is currently being defined.
These can be customized however you like.

Suggested set names:
GFA Lib   = unmodified from GFA Systemtechnik GmbH
GFA Patch = patched by Deep Sleep (GFA-Patch v1.07)
LicomLIB  = patched by RGF Software
GBE Lib   = from Lonny Pursell   WWW: http://gfabasic.net/
 and ENCOM   WWW: http://gfabasic.net/

RUN Lib   = from RUN! Software

Compiler path:
Path to the compiler for the current set.

Remove extension .GFA
On  = Remove extender before passing the source file to the compiler.
Off = Pass source file as is, with extender.
Note: See table below.

Linker path:
Path to the linker for the current set.

Remove extension .O
On  = Remove extenders before passing additional object files to the linker.
Off = Pass additional object files as is, with extender.
Note: See table below.

Library path:
Path to the library file for the current set.
Do not set this to the '.ndx' file!

Rebuild *.NDX
This option will rebuild the *.NDX file for the currently selected
Compiler/Linker set.  The output is functionally identical to that of the
MAKE_NDX.PRG program as supplied by GFA.  If you happen to lose your index
file or if you are working with a modified library, then this option will
be very handy.


Compiler/Linker workaround table:

Library    Compiler  Linker
GFA Lib    On        On
GFA Patch  On        On
LicomLIB   Off       On
GBE Lib    Off       Off
RUN! Lib   On        On

The reason for these workarounds is related to the various bugs in each set.
If these are not set correctly, the Compiler and Linker in some cases won't
be able to find the files passed to them.