CGLE (V00498)


      (for VAX installation see INSTALL.TXT)

CGLE is NOT WYSIWYG, it shows you a close approximation to what you
will get, but fonts, line widths, colors may all be slightly incorrect. 

Please send reports of bugs (including the GLE file) to:
		        in%"srghcxp@grv.dsir.govt.nz"

The rest of this file contains version update notices, they are in
REVERSE chronological order.  (e.g. recent changes first)

			
				Chris Pugmire.
CGLE 3.2 (6-Mar-1990)
---------------------
      File type changed from STREAM_LF to normal vax format.
	
      SMOOTHM option added which is identical to SMOOTH but
      will allow multi-valued functions. (e.g. circiles etc)


CGLE 3.1e (1-Mar-1990)
----------------------

      Errbars will now work with the bigfile option.

      x2ticks now come back on again if you turn the xaxis off and x2axis on
      (The error bars distances cannot also be a bigfile)

      if you use a let d1 = exp from 1 to 10000 step 1
      with a log xaxis it doesn't produce a smooth line.  GLE now
      checks and if the xaxis is a LOG scale then it uses the
      step option as an approximate required number of intervals which
      it spreads along the xaxis in increasing steps.

      In the graph module, if you use '0' as a column for the x data
      of a bigfile GLE will generate xdata of 1,2,3,4 ...
      e.g.  d1 bigfile a.dat,0,2 

      Data separated with commas and no spaces was being read incorrectly
      The data reading routine has been re-written. (introducing new 
      and more interesting bugs in the process)


CGLE 3.1d (19-FEB-1990)
-----------------------

      In the past  "TEXT a\delta b" would have produced a space
      between the delta character and the letter b,  this action
      was incorrect and had been fixed. 
      Use "TEXT a\delta\ b" to get a space.

      "TEXT a(\delta)b" also works now.


CGLE 3.1c
---------

      Built in functions twidth("") and theight("") now work.

      Their is now a BIGFILE command for executing large gle files 
      that won't fit into memory using INCLUDE. (note this should
      not be confused with  the BIGFILE graph command).
      e.g.  BIGFILE NZMAP.GLE
      
      As bigfile compiles and executes the gle file one line at a 
      time you cannot use multi line structures (subs, if then else etc)
      but you can call subroutines if they are defined before the bigfile
      statement.

      Lines in bitmap drivers are now the right length (text looks better)

      There is currently a limitation on the size of text or tables that
      can be printed (this may be fixed at a later date)

      The xg() and yg() functions now work if the graph has log axes

      A bug which stopped the last line of a data file being
      read had been fixed.

      Correction to expression passing allows IF A$="ABC" THEN ... to work.

      Added shading styles RSHADE, RSHADE1, RSHADE2 ...(Lines at right angles)


CGLE 3.1b
---------

      Fixed the circle fill command so it uses the right colour.
      
      Modified PostScript arrows with wide lines so they look nice.
      They are now filled triangles rather than two short lines.

      There is now an example in BOXR.GLE which shows you how to 
      define a subroutine to draw boxes with rounded corners.

      Horizontal error bars have been added, the commands are
            HERR, HERRLEFT, HERRRIGHT, HERRWIDTH 

      If you had the same subroutine defined twice in a gle
      file it would skip the intervening gle commands, this is fixed.

      Arcto fixed for line devices (hpgl)

      Stacked bargraphs should not contain missing values,  replace
      missing values with the value from the column on the left. e.g.
            1 22 * 45  becomes          1 22 22 45


CGLE 3.1a
---------

      Bug with reading exponential format numbers fixed.

      Bigfile option added, so that you can extract particular 
      columns of data from a data file, e.g. 
            D1 LINE BIGFILE TEST.DAT,3,2
      Will use column 3 for x values and column 2 for y values.

      e.g.
'           data x.dat
            d3 line
      becomes
            d3 line bigfile x.dat,1,4
      As dataset three is made from columns 1 and 4.

      The space codes (\: \; \,) are now proportional to the
      current font size.

      text \rule{2}{3}  will draw a box, and \glass can be used
      to offset text.

 
CGLE 3.1
--------

      Modified default DPOINTS setting so that if DTICKS is not a 
      whole number it will display one decimal point.
      e.g. (1.0,  1.5,  2.0) instead of (1   1.5   2)

      the  "graph data d2=c3,c1"  option now requires no spaces 
      within the "d1=c1,c2"

      Begin path wasn't issuing a newpath, so multiple paths 
      got added together.

      Gle files can now begin with a numeric character.

      Bug with bitmap drivers fixed (dviepson, dvilj300 etc) which 
      resulted in a stray horizontal line on the page.

      The editor doesn't display long lines correctly,  it does 
      store them though.

      On the PC  the PSGLE driver now writes output files 
      to INPUTFILE.PS instead of out.ps   e.g. bar.gle --> bar.ps

      Added \linegap{-1} tex primitive to stop odd spaces lines
      when using super/subscripts.
      vscale and hscale were not being reset after each graph.


      Some of the characters which were missing from the PLOTTER fonts
      have now been installed (e.g.  []{}<>% )

      You can no add lines and text to a drawing using the mouse or arrow
      keys on the PC version of gle. 

      There is now a graph command, FULLSIZE which sets 
      vscale,hscale to 1,  and turns the border off.


CGLE 3.0h
---------

      Fixed bug with LSTYLE in PSGLE (on the pc only)

      You can change the size of the default key by setting the
      hei of text used to draw the key. e.g.
      begin graph
            ...
            key hei 1.2
      end graph

      If the value of an error bar length is a missing value then that 
      particular bar won't be drawn.

      If you escape out of the idiot graph creation menu it will now 
      correctly put an END GRAPH in your file.

      Line and Grid shading has been added to the postscript 
      device driver, the following colour names are now accepted.

      shade,shade1,shade2,shade3,shade4,shade5
      grid,grid1,grid2,grid3,grid4,grid5

      e.g. BAR 2 3 FILL GRID3

      Print the example file SHADE.GLE on a postscript printer 
      and stick it on the wall for reference.  ($ cgle shade /print)

      Bug with changing diskdrives on a PC is fixed.

      The fonts SSBI and SSI were reversed on the laser printer.

      There is now an axis qualifier SHIFT for shifting the labelling
      horizontally (when the label refers to the data between the 
      two ticks) e.g.
            xaxis shift .4

      In order to put a large space between two words you must 
      use these control sequences e.g.  TEXT  Hello \; world
            \,   =     .1cm
            \:   =     .2cm
            \;   =     .4cm

      Use \_ to get an underscore character inside text
      ("_" normally means subscript) 

      Fixed X2AXIS SIDE ON 

      HPGL Plotter pens 1=black, 2=red, 3=green, 4=blue, 5=magenta, 6=white

      Bug fixed in linestyles caused by the cap being set to ROUND which 
      merges the dashes together for wide lines on the laser printer.


CGLE 3.0g
---------

      Fixed bug with smoothing more that 200 points
      Fixed bug with joining between saved objects.

When using the plotter fonts you may find some characters are missing,
      e.g.  %,[ and ]  (These have now been put into these fonts V3.1)
The following command will replace these characters with latex equivalents.
      size 24 18
      text \chardef{%}{{\setfont{texcmr}\char{37}}}
      text \chardef{[}{{\setfont{texcmr}\char{91}}}
      text \chardef{]}{{\setfont{texcmr}\char{93}}}
      ... rest of gle file


CGLE 3.0e (17-Sep-1990)
-----------------------

Missing values are not used to calculate new dataset values during 
a let command (e.g.  "let d3 = sin(d2)")

Fixed bug in LOG data display.  (If you have used LOG axis prior to 
this release you SHOULD replot your graphs)

The bigfile option now works with markers as well as lines.
            (e.g.  "d3 bigfile "year.dat" lstyle 1 marker dot ")


CGLE 3.0d (5-SEP-1990)
----------------------

The default labelling of axes is sometimes not ideal, for example
      0     0.333333   0.6666667        1.0
you can now adjust this with the command "XAXIS DPOINTS 3" which sets 
the decimal places for an axis.  e.g.
      0.000 0.3330.666   1.000

The MSCALE option now works.

Markers have been reduced in size, this will affect existing gle 
files, they are now approx 60% of there original size.

The bigfile option now works on postscript printers, there was a bug 
caused by sending an entire 10,000 point curve to the printer as one path
which it choked on if it was short of memory.

You will occasionally get an error message "PATH TOO COMPLEX" this means
that GLE decided to split up a line into shorter segments.  Normally
this WARNING can be ignored.

The default axis labelling of  1, 1.5, 2  has been changed to  1.0, 1.5, 2.0
Exponent axis labelling has been fixed 2.00000e4 becomes 2.0e4 

      *** NEW DEVICE DRIVERS ***

CGLE now supports the EPSON 8PIN and 24Pin printers, and the 
HP deskjet/laserjet printers.  To support bitmap devices which require
a large amount of memory GLE first writes a device independent file
OUT.DVI, you then run the bitmap driver for your printer and that prints
directly to LPT1:  e.g.
      C:\GLE> dvigle myfile        (produces OUT.DVI)
      C:\GLE> dviepson       (creates bitmap and prints to lpt1)

The output options are:
      C:\GLE> DVIEPSON Standard epson printer
      C:\GLE> DVIEP24        24 Pin epson printers (180 dpi)
      C:\GLE> DVILJ          HP Laser jet, Desk jet (150 dpi)
      C:\GLE> DVILJ300 HP Laser jet, Desk jet (300 dpi)
The hi resolution drivers are significantly slower (2-3 times) than the 
low resolution drivers so would only be used for final copies.

By default the fonts (RM, RMB, SS, TT etc) will all map to PLSR (plotter 
simplex roman) on both bitmap drivers and the HPGL driver.
If you want this to happen on other drivers then put the
command "PLOTTER FONTS" right after your SIZE command in your gle file.

An lwidth of .00001 on a laser printer will give you 1 pixel width lines.
(and won't occasionally round to two pixels)

Using Postscript and HP drivers on the PC:
      C:\GLE\> PSGLE MYFILE.GLE    (Writes myfile.ps)
      C:\GLE\> HPGLE myfile.gle    (Writes out.hp)

Making a 360K distribution diskette from the 1.2M diskette.
(if a: = 1.2Meg disk,  b: = 360K disk)
      a:> copy a:install.exe b:
      a:> copy a:pkunzip.exe b:
      a:> copy a:cgle.zip    b:
      a:> copy a:cglet.zip   b:
      a:> copy a:cglee.zip   b:
      a:> copy a:cglef.zip   b:

To install CGLE on a pc type:
      C:\> a:install 
or for black and white monitors:
      C:\> a:install /bw


CGLE 3.0c
---------

Bug with LaTeX symbols in graph titles fixed. 

Extra graph dataset qualifiers "BIGFILE and NOMISS"
      NOMISS removes missing values from a dataset.  (so disjointed lines
      are re-connected)  (e.g.  "d3 colour red nomiss")
      BIGFILE allows a very large dataset to be drawn on a PC, it doesn't
      read the dataset into memory as usual.  (but must be in a file 
      with only one dataset, and no BARS or markers can be drawn.
      And axis ranges must be specified by hand.
      (e.g.  "d3 bigfile "year.dat" lstyle 1")

Fonts:      The LaTeX greek font is missing from the small distribution disk.
      It is now possible to copy on any missing font directly into the 
      c:\gle\font\ directory. Copy both the FMT and FVE files. 
      e.g. "texcmmi.fmt, texcmmi.fve"

      set join mitre | round | bevel
      set cap but | round | square

Fixed:
      Superscript, Subscript
      Symbols on Laser Printer after white fill.
      Individual dataset scaling fixed.
      
Notes on new Drivers:  HPGL, TEK4010, P79.
      HPGL: With this driver you can define the symbols
            hpgl_open, hpgl_close to be the escape
            sequences required for strange hp printers.
            also HPGL_WIDTH, and HPGL_HEIGHT for non A3 plotters
      
      TEK:  TEK_OPEN and TEK_CLOSE can be defined to allow
            non dec tektronix terminals, e.g. TEK_OPEN = "^[?38h"

      (this is normally done in CGLECMD.COM so that when you specify
      /DEV=V550, OR /DEV=HPA4 it defines the symbols for you.

      On the vax the following cgle dev qualifiers are valid:

            cgle myfile.gle /dev=vdisk,v550,hpgl,tek
      Plus any P79 supported device, your output file will be  MYFILE.HPGL


CGLE 3.0b
---------

2) Currently supported devices:
      PC version:
            HERC, EGA, CGA, etc (any BGI supported display)
            PostScript
      VAX version:
            REGIS(VT125,VT240,VT340 etc)
            UIS  (Workstations running VWS software)
            PostScript
      (additions to this list lower down)
3) Fonts:
      The PC version comes on one 360K floppy, on this disk is a 
      subset of fonts, if you use a font that isn't on this disk
      it will use a replacement font, and replacement metrics so
      the size of the text may be misleading.
      If you have enough disk space (another 1Meg) then you can
      install the complete font set.

4) PostScript:
      The PSGLE driver is not on the 360K Floppy, you must install 
      it separately if you have enough disk space (another 400K)
      (or copy gle and data files to a VAX and use the vax
      PS driver)

5) Using CGLE on a VT100/VT240
      If your keyboard doesn't have function keys (f9-f14) then you
      can use GOLD 1-4 (for 11-14) and GOLD 0 (for f10) and
      GOLD 9 (for F9)  GOLD 5 (show errors)

      If you run CGLE on a vt100 it will work OK but not actually DRAW
      anything on the screen (as it thinks it's a vt240)

6) Other keyboard features:
      ^F will toggle between fast and slow (but nicer text) on some devices
      ^E will call VAX/EDT
      ^Z Exits from all menu's etc (like ESC on a PC)
      ALT-X Exits on a PC without asking you for confirmation.

7) There are currently no drivers for Plotters or DotMatrix Printers, 
these are planned for the next month or two   (see update notices below)

8) Additions:
      The command "SET FONTLWIDTH value"  has been added, this allows
the line width of stroked fonts to be changed.

Click on FTP to download from the FTP archives.
[FTP]