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 settings which you don't change often.  Items you rarely
have to alter once set for your system.

Source code buffer:
The value entered here determines the exact size of the source code buffer
in bytes.  Smallest value allowed is 131,072 bytes.  Note: The editor must
be exited and restarted to take effect.

Closer Quits
Toggle closer gadget function.  Close window versus exit program.

Disable Auto Run
Off = Acts like the old editor.
      - d:\path\file.gfa (loaded only)
      d:\path\file.gfa   (loaded and started)
On  = Supress auto run.
      '-' is stripped and ignored (load only)

Enable =>68020 options
Toggle 68020 and up CPU enhancements on/off.
If you suspect this is causing problems leave it off. It also requires GBE
be restart to disable it. It won't help on a FireBee, since most of the
enhanced instructions end up emulated. Pressing the ESCape key will show the
status of this option.

Enable Long File Nanems
Toggle long file name support. (Off=8+3)
Note: Was causing me problems with Control-Z (seemed to freeze the process).
      I can't explain it, so hense the toggle.  Use at your own risk.

Enhanced Keyboard Mode
Toggle key board mode.
Off = Standard layout like the old editor.
On  = Modified layout. (See keyboard shortcuts for details.)

Output format:
Used by the .dot commands that accept # and \d.
Also used anywhere a date is displayed.

External Editor Mode
This will allow GBE to work better with ergo!pro from RUN! Software.
On  = GBE accept empty (new) projects without complaining and note the path.
      This only works if the path was delivered via a command line.
Off = GBE will inform you that the file passed via command line was not found.
      The default path will be used along with 'untitle.gfa'.

Auto top window at Help
This will force the editor window to re-top itself after opening ST-Guide.
Very handy if you have a lot of screen space.

MiNT Pterm() Workaround
This options helps to solve an issue with older MiNT kernels. If for example
the compiler can't find a file and it reports error code '223' when it really
should be '-33', then you need to turn this option on. If this is not set
right, GBE cannot correctly report errors from externally called tools. This
includes the compiler and linker and import modules.

Show merge counter
Toggle real-time merge counter readout.  Note: Slows down *.LST merging.

Taskbar Height:
This option keeps windows from covering Taskbar when a window is set to
it's fullest size.  Enter the pixel height of your taskbar.  (0=off)
Enter '1' to auto detect your taskbar using a simple method. There is no
standard for determining the height of the taskbar so this might fail.

Source code unsaved indicator:
This character appears in the window info line.  If this character is visible
it means the source code currently in the editor has not been saved.
Default is '*'.  Good choices might be: ° ∙ ^ ∆ !

Clock Refresh:'
Determines how often the clock is updated.
Range: 2-10 seconds

Restore Last Session
This option causes the editor to remember the source file that is loaded
at the moment the editor terminates. If this option is on, the source file
will be auto loaded the next time the editor is started.

Note: A command line will over-ride this feature.

Restore Source State
This option detemines if the editors saved state is restored at load time.
The data is always saved.

Off = Load file the old way.  Place cursor at the top of the listing.
On  = Load file as it was when I saved it.  Place cursor, etc...

Saved state notes the following settings:
  Current cursor Y position (X always = 0)
  Current marked block if defined
  Current editor marks (all 10)
  Current Find string
  Current Replace string
  Current Find/Replace history (all 10)
  Current cut/paste string (Control-O)
  Current undo string (Control-U)
  Current command line
  Current environment variables

This data is stored in the *.gfa file.
It is still 100% compatible with the old editor and old compiler.