******************** VERSION 3.2 CHANGES *******************


--------------- CHANGES AFFECTING GUIS OF PREVIOUS VERSIONS:

  Only one change, which will not greatly affect your guis :

  Now a gui's variables are considered to be PRIVATE by default, 
  i.e. without having to previously issue the VARPATH command.
  It's more straight forward this way.

  If you have any problems, just add the global command: 
  - VARPATH '*' - to your guis. 
  If you still have problems you must trace down the variables you 
  want to have as Global, and put a * in front of them.


--------------- HELP:

  Now help for gadgets is available through the gadget modifier :
  >  GADHELP 'This is some help text'

  To turn the help system on/off you can hit the HELP key, or give 
  the command SET HELP ON|OFF


--------------- NEW EVENTS:

- xPIPE  PIPE:FileName  ON|OFF
  will launch a new process which will open and monitor a pipe: file
  and will send you any output that any program redirects to it in
  the form of lines of text via the internal variable $$PIPE.TXT
  - SetGad now has a new keyword CLEAN, used *only* for pipes.


--------------- NEW COMMANDS:

- xLVINSERT RecordNumber string
  will insert the given string *before* the given record. 
  RecordNumber of -1 means the CURRENT record. 

- BREAKTASK TaskName CDEF (signals) signals a task named TaskName
  with a given combination of signals - like if you used the Amigados
  break & status commands together. Usefull for stopping programs.

- SET DEEPTRANS ON|OFF - setting DEEPTRANS OFF will stop Gui4Cli from
  translating variables within variables - this will last for one
  execution cycle. This comes useful in the filetype checking routines
  which are now much faster.

- PARTREDRAW GuiName L T W H - will redraw only part of the window.
  Use this if you're just changing some gadgets in one area of the
  window and do not want a full redraw. It's easier on the eyes..

- SETGADVALUES GuiName - will store the values of all the gadgets of
  a gui into their respective variables. This is usefull at the 
  start of a gui, when you have to set the default values of your
  variables.


---------------- VISUAL EDITING IMPROVEMENTS:

- CONTROL-J while in GUI Visual Editing mode, will now clone the 
  gadget in it's own window.

- A GRID is now available, which makes lining up the gadgets much
  easier. By default the grid size is 1 which means "no grid".
  You can set the grid size with "SET GRID 5" (5 is a good size..)

- Gui4Cli will now adjust the position of ghosted gadget you move 
  around while editing, to keep it inside the window borders. This
  does not effect inter-gui cloning which works as usual.

- Various small bugs were exterminated (see bug-fixes below).


---------------- TEXT IMPROVEMENTS:

- CTEXT last argument (the mask for underline|bold|italic) now works...
  Also, it has 2 more digits :
  Digit #4, is the color number of the "shade" which the letters will be 
            shaded with, producing a 3D effect.
  Digit #5, is the size of the shade (defaults to 1)
  You need not declare these two.. 

- Also in CTEXT, if you give -1 as the background color, the background
  will not be disturbed. Useful for writing over an Image background..

- CTEXT, WINFONT and GADFONT now also recognise the following :
  - #MONO    specifying the default Monospace font, and
  - #SCREEN  specifying the Screen font, which is usually proportional.
  It is best to use these two in GUIs which you want to distribute.


--------------- LISTVIEWS:

- COLORED, fancy text can now be seen in listviews! (only WB 3.0+)
  Listviews will now interpret and render all the console sequences 
  which set text color and mode (bold etc). See "Important Topics".
  (also read this text with it..)

- A new type of listview "SHOW" which is exactly like "TXT", except 
  that the selected choice will remain highlighted.


--------------- DIRECTORY LISTVIEWS:

- DIR ListViews will now show you the directory sizes next to the
  dir name, if you issue a LVAction ..SIZE.. command.


--------------- EXTENDED VARIABLE NOTATION:

- NORMAL variables now have extended notation:

  - Private	GuiName/VarName[start][length]
  - Globals	*VarName[start][length]

  Apart from the VarName bit, all other components are optional.
  Read all about it in "Important Topics"


--------------- NEW INTERNAL VARIABLES:

- $$WIN.PATH will tell you the path of the current or infoed gui.
  (same as extract gui guipath var)

- $$GAD.VAR is the name of the variable that the given gadget will
  store it's value in.

- $$G4C.DEFSCREEN - The screen name which all guis get (default = '*')
- $$G4C.OUTPUT - The default console output spec
- $$G4C.FILEPATTERN - The default ASL requester file pattern
- $$G4C.EDITOR - The default editor name (c:Ed)
- $$G4C.GUIPATTERN - The dafault gui extension (#?.gc - for the requester)
- $$G4C.GUILOADDIR - The dir that the G4C load requester will open at


--------------- ARGUMENTS FOR ROUTINES:

- New and powerfull improvement (read "GOSUB/GUILOAD" in the guide):

  Commands which call other events (like Guiload which calls xOnLoad,
  or GoSub which calls a routine) can now take up to 6 arguments which 
  are passed to the routine the given command calls, in the form of 
  Internal variables $$ARG.0 to $$ARG.5. -OR- (if defined in the 
  event's command line) automatically converted to variables.

  $$ARG.TOT contains the actual number of arguments passed. 

- Furthermore, RETURN can also now return from the routine or xONLOAD
  etc, with up to 6 more arguments, which are passed back to the 
  calling GoSub or GuiOpen etc as internal vars $$RET.0 to $$RET.5.


--------------- SCREENS:

- Up to now, the screen name that Gui4Cli used if no Screen had
  been declared for a gui was "Workbench". Now it's the "*" character
  which means "The Front Most Screen". i.e. now, your guis will open
  by default on the front most screen.

- This default screen name can be changed with :
  SET  DEFSCREEN  Workbench   (or whatever..)
  Note : This is *not* the same as the OS's default screen..


--------------- BUG FIXES:

- Fixed redrawing of windows when being resized which sometimes
  left trash at the bottom of the window.

- UNLOADIMAGE which did not seem to work in version 3.1, is actually
  called FREEIMAGE. (yes.. I'm not perfect.. it was a big suprise to 
  me too..)

- Fixed some bugs in $$lv.rec and LVSearch/LVFind commands.

- Fixed some bugs in GuiEdit. The Cyclers/radios will now save correctly.
  ** HOWEVER ** if you add a cycler or radio (by cloning it) and save the 
  gui, you'll have to reload it before you can edit it again, because
  these gads add lines to the gui and Gui4Cli will think it's an error.
  Also fixed some other stuff..

- Fixed SetWinTitle command which effected the titles of other windows.

- Added a version string for the c:version command.

- Fixed extract EXT which did not remove quotes

- Optimised command linking when loading file - Loading should now be
  faster by a nano-pico-millisecond or two...

- Fixed a bug with the initial size of the resizable borders which 
  showed up when using the VisualPrefs program (which changes the screen
  structure border sizes).