
                32-bit DOS version of GLE by Axel Rohde
                ---------------------------------------
                        Version 3.3 h

Introduction: (By Chris)
        For a long time I have been explaining to people that a 32bit 
        dos version of GLE was not possible with currently available 
        compilers and libraries.
        Clearly Axel has no appreciation for the impossible and has gone
        ahead and compiled a version anyway (with absolutely no assistance
        from me).  On any 386 or better machine this version of GLE should 
        run without problems, it's main features are these:
                1) No 640K memory restrictions.
                2) Much faster.

Installation Quick guide:       (By Chris)

        1) FTP the binary distribution
                ftp tui.marc.cri.nz
                cd pub/gle/gle32
                binary
                get gle32bit.zip
                get gle32bi2.zip
        2) Unzip them keeping the directory structure
                cd c:\
                pkunzip gle32bit.zip -d
                pkunzip gle32bi2.zip -d
        3) Edit the batch file which tells gle where to find it's fonts
        and also what sort of graphics card you have.  
                edit setgle32.bat
                        (change the disk and directory as appropriate)
        4) Run the batch script
                setgle32
        5) Try out the new version
                gle_vga
        6) Note most of the programs have been renamed to avoid conflicts!!!


        Below are the more detailed instructions provided by Axel Rohde.
        Read these carefully if you have any problems.

________________________________________________________________________________

                  Installation Manual and Documentation 
                     for the 32-Bit DOS version of
                                GLE 3.3 h
        
                              by Axel Rohde
________________________________________________________________________________

 GLE 32 is an implementation of GLE for MS-DOS. It was compiled using the
 free port of the GNU C compiler DJGPP by D.J. Delorie. The compiler itself
 and the DJGPP-compiled executables use a 32-bit DOS-extender called
 GO32 by the same author.

 The benefits of the 32-bit implementation are

 - All programs run in the 386-protected-mode and therefore there is
   neither a limited 640kB adress range nor a 64kB segmentation. They can
   use all expanded memory, and if it's not sufficient, GO32 will swap to
   disk. The maximum memory size GO32 can handle is limited to 128 MB.
 - 32-bit programs run much faster than their 16-bit counterparts.
 - There is a multitude of GRX graphics drivers available, e.g. for
   TSENG ET4000(W32), S3, 8514A, Cirrus Logic GD 542x, Trident 8900,
   Diamond Viper, ATI Ultra, ATI VGA and EGA boards. These drivers are highly
   configureable and can provide flickerfree high resolution modes.

 GLE 32 runs only on Intel i386SX and above or compatible CPUs. GO32 comes
 with a coprocessor emulator for those machines without a floating point
 processor. Real-mode coprocessor emulators don't work with GO32.

 GLE was compiled using Borland C compatible libraries for text and
 graphics routines and some filesystem calls.
 The basic graphics library is GRX, Version 1.03, by Csaba Biegl. An additional
 library called BCC2GRX, Version 1.3, from Hartmut Schirmer is used to replace
 calls of the Borland Graphics Interface (BGI) with GRX calls.
 Hartmut and I implemented the mouse functionality of the VGA prewiew
 (gle_vga), too, with GRX calls. Copyright statements are at the end of this
 file.


                            Installation
                            ------------
  Don't panic...

  To understand the next lines, you should have a basic knowledge of
  the MS-DOS operating system and PC hardware. Take a look into
  your DOS manual and your hardware documentation in case of doubt.
  
  The DOS extender GO32 1.11 has different modes of operation:

  1) VCPI: VCPI is an extension to EMS. EMS can be installed using
           the driver EMM386.EXE of MS-DOS 5.0 or higher. You don't have to
           install EMS if you're using MSDOS 6.? (the new EMM386.EXE can
           handle VCPI without installing EMS).

        MS-DOS 5.0:
           The (unoptimized) entries in the system file CONFIG.SYS of
           MS-DOS 5.0 are looking like the following lines:
           
                DOS=high,umb
                device=c:\dos\himem.sys
                device=c:\dos\emm386.exe RAM 2048

           The switch <RAM 2048> installs 
           a) 2 MB EMS in the memory area above 1MB,
           b) a page frame with a size of 64kB between the memory area
              of the graphics board and the BIOS (upper memory).
           Programs, that use VCPI calls, can NOT run under Windows or the
           DOS emulation of OS/2 2.x. Other products, such as QEMM386, can
           also be used to install EMS.

        MS-DOS 6.?:
           MS-DOS 6.2 is happy with the following CONFIG.SYS entries:
           
                DEVICE=C:\DOS\HIMEM.SYS /TESTMEM:OFF
                DEVICE=C:\DOS\EMM386.EXE NOEMS HIGHSCAN
                DOS=HIGH,UMB

  2) DPMI: DPMI can be installed with special drivers like QDPMI (along with
           QEMM 6.0 or higher) or 386ToTheMax 7.x. Both the DOS emulation of
           OS/2 2.x and Windows 3.x provide DPMI as a default. The
           DPMI interface does not allow direct access to graphics hardware.
           Only those programs, that don't use graphics mode, can run with
           DPMI. I recommend to run GLE 32 under plain MS-DOS 5.0 or 6.2.
           I don't know anything about the interaction of DR-DOS 5.0/6.0/
           NOVELL-DOS 7.0 with GLE32. It perhaps may only work along with
           NOVELL-DOS 7.0, if multitasking is disabled.

   To avoid name conflicts between a 16-bit and a 32-bit version of GLE,
   all programs and environmentvariables were renamed.
   All GLE programs have now UNIX style names like 'gle_ps' (='psgle' <->
   Postscript output), 'gle_vga' (='cgle' <-> VGA preview), etc. The names
   of the utilities end with '32' -  'manip32', 'contou32'.... 
  
   For the example on the following lines, the progams are installed in the
   directory d:\gle32, the vector fonts are in d:\gle32\font. GLE 32 searches
   for the help files, inittex.ini and init.ps in the directory GLE_TOP and for
   its vector fonts in the directory GLE_TOP/font -> d:/gle32/font.
   In addition to this, GLE32FONT points to the directory where the
   bitmap fonts (you can see them in the status line of the preview) can be
   found. The directory witch contains the GLE executables, the DOS extender
   GO32 and, if there's no coprocessor installed, the coprocessor
   emulator EMU387, must be in the path environment. 

     set GLE_TOP=d:/gle32
     set gle32font=d:/gle32/grxfont
     path=..your normal path..;d:\gle32;
     go32=driver d:/gle32/driver/vesa_s3.grn gw 1024 gh 768 tw 80 th 25 nc 256 

   A slash as last character of GLE_TOP is no more neccessary (but can still
   be there).

   The configuration of a graphics driver is a little bit more complicated.
   Please study the documentation of the Libraries GRX und BCCGRX and
   the README of GO32 in their directories. In the example above,the
   environmentvariable GO32 sets the path name and the mode of the driver.
   This example installs the driver for a S3 graphics board with a
   resolution of 1024 horizontal 768 vertical pixels and 256 colors.
   Although you can use a 256 colour driver, GLE never uses more than 10
   colours. In other words, a 16 colour mode is sufficient and may be faster.

   There's a prepared batch file 'setgle32.bat' to set all the environment-
   variables in the directory gle32.
        !!! Don't run it from the Norton Commander or a similar Shell !!!
   To call it from your autoexec.bat is the best way.
   Add this line to your autoexec.bat:
   
        call d:\gle32\setgle32.bat


   To figure out, which graphics modes are supported, try to run the program
   'modetest' in the directory gle32\driver\doc.

                           !!!! WARNING !!!!
   A graphics-mode that drives your monitor not within it's specifications
   can DESTROY your MONITOR and/or graphics board). This usually happens,
   if the vertical or horizontal refresh rate is too high.
                   !!! USE THESE PROGRAMS ON YOUR OWN RISK !!!

   You should take a look into the manuals of your monitor and your
   graphics adapter to figure out, which modes and refresh frequencies
   are supported.

   If the horizontal frequency of the monitor is 64 kHz or higher, you
   **MAY** feel save, since most of the boards use 56kHz/70Hz hor./vert.
   refresh rates in the 1024x768 mode, which is a VESA standard, although
   some boards support much higher rates.

   If it is possible, to set the refresh rates with utility programs or dip
   switches, set the horizontal frequency of your graphics board
   equal or smaller than the horizontal frequency of your monitor.

       !!! If you want to go save, don't set the environment GO32!!!

   This will use the normal (flickering) VGA mode on a VGA compatible
   adapter.



                            RESTRICTIONS and BUGS
                            ---------------------
   1) The vector-fonts of the 32-bit version are NOT compatible to their
      16-bit counterparts. They may be compatible to fonts that were created
      under other (small endian!) 32-bit operating systems such as Linux.
      If you use GLE under Linux, too, it may be a good idea to mount the
      DOS-partition, that contains GLE 32 (including fonts) and create a link:

      ln -s /dospartition-mount-directory/gle32/font /usr/local/gle/font

      This will save approximately 900 kB harddisk space.

   2) Surface (surf_vga) hanged under unknown circumstances while loading
      **one** data file. Surf_vga can be killed by pressing Control-Pause
      (Control-Break on some keyboards).
      If this happens, load the data file into an editor, save it, and try it
      again. This may work if you have the same error in your data file.


                             New features
                             ------------

   surface has a new keyword: nobigfile
    If 'nobigfile' is specified somewhere in a .sur file, surface does
    not waste time to write a .big file for GLE. This increases the
    performance while you're 'designing' the plot

   GLE tries to read files to **include** from two library directories, too.
   The system wide library directory is GLE_TOP/lib. Each user (I don't plan
   to write a 'multi user DOS') can have an additional library directory:
   
       set GLE_USRLIB=c:/users/joe/glelib

   Try to run ftest.gle.      


                             Other News
                             ----------
   Are you using OS/2? I have ported GLE to OS/2! Since GRX does not run under
   DPMI, it is a real OS/2 implementation with graphics output on the PM.
   There is no mouse support. GLE for OS/2 uses the same fonts as GLE 32 and
   the release for Linux. You can get GLE for OS/2 from tui.marc.cri.nz
   (GLE's home site) or ftp.informatik.tu-muenchen.de (131.159.0.198).
   The Linux version (source + binaries) is available from sunsite.unc.edu.


                              Related utilities
                              -----------------

   You should get Ghostscript from a ftp site! Especially if you have
   a supported color printer (HP Deskjet 500c, 550c). Ghostscript prints
   Postscript output on not postscript capable devices. It can convert
   Postscript to various bitmap formats.
   It runs on i386 processors and higher using a DOS extender.
   Ghostscript is free usable (GNU Public License), fast and reliable.
   Ghostscript does NOT have NICE fonts, but you can use those that come
   with Adobe's Typemanager and OS/2 2.x (*.pfb). GLE's TeX fonts
   (texcmr, texcmss etc.) look nice, when printed with gle_ps and Ghostscript.


                Access to the DJGPP patches for the Source
                ------------------------------------------
   I uploaded them to Chris Pugmire's FTP-server (tui.marc.cri.nz).
   You need a version of Hartmut Schirmers BCC2GRX-library newer than
   version 1.2 to (properly) compile gle_vga and surf_vga. You can
   get it from tui.marc.cri.nz, too.


                        Postscript Documentation
                        ------------------------

   The original Postscript documentation of GLE 3.2 has been replaced by
   Stefan Mundt's reworked version. It can be printed on Postscript Printers
   or with Ghostscript on supported, non Postscript capable printers.
   I omitted the very large appendix. It contains tables of various fonts.
   It's seperately available from tui.marc.cri.nz, too.
  

                   Getting help on GLE problems
                   ----------------------------

    There is a mailing list to *get* and *give* help on GLE problems.

    To subscribe send a mail to:
        listserver@tbone.biol.scarolina.edu
    with a message containing:
        sub glelist <your name>

    You can then ask questions or send messages, bug reports or work-arounds
    by email to:
        glelist@tbone.biol.scarolina.edu.
    

   Please take a look into the manual, before you ask :^)


                              LEGAL STUFF
                              -----------
 LIKE ANYTHING ELSE THAT'S FREE, GLE 32 AND ITS ASSOCIATED UTILITIES ARE
 PROVIDED AS IS AND COME WITH NO WARRANTY OF ANY KIND, EITHER EXPRESSED OR
 IMPLIED. IN NO EVENT WILL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY DAMAGES
 RESULTING FROM THE USE OF THIS SOFTWARE.
  
 These programs are distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 

 Copyright-holders are:

 GLE:             Please ask Chris Pugmire (email: srghcxp@grv.dsir.govt.nz)

 DJGPP and GO32:  D. J. Delorie, GNU LIBRARY GENERAL PUBLIC LICENSE and
                  GNU PUBLIC LICENSE,
                  see the files in the directory gle32\go32.doc.

 GRX:             Csaba Biegl, GNU LIBRARY GENERAL PUBLIC LICENSE,
                  see gle32\driver\doc\grx.doc and gle32\driver\doc\bccgrx.doc.
                  
 BCC2GRX:         Hartmut Schirmer, GNU LIBRARY GENERAL PUBLIC LICENSE,
                  see gle32\driver\doc\bccgrx.doc.

 MS-DOS, Windows: Microsoft Corporation.

 DR-DOS:          Digital Research. Doesn't exist anymore.
 NOVELL-DOS:      NOVELL.

 QEMM386, QDPMI:  Quarterdeck.
 
 386ToTheMAX:     Qualitas.
 
 i386SX, i386DX, i486SX, i486DX:        INTEL.

 OS/2:            IBM.

 HP Deskjet:      Hewlett Packard.

 Ghostscript:     Aladdin Software.
 
 DJGPP, GRX and BCC2GRX are available from many ftp sites. For examples see
 the file gle32\driver\doc\bccgrx.doc.


  Thanks to:
  ----------

  Chris Pugmire         for creating GLE.

  D.J. Delorie          for porting GCC to DOS
  all the GCC and Gnu people and all other people, who write free software.

  Csaba Biegl           for GRX 
  
  Hartmut Schirmer      for BCC2GRX, GRX under Linux and help with GLE 32.

  Kordt Griepenkerl     for the book and for bug-reports.

  Ed Nather             for reporting bugs + fixes.

  Andrey Grozin         for the contribution of the Feynman Diagram Library.

  Joe Huber             for the hint, that ecvt() is never used.
         
  Dream Theater,
  Fates Warning,
  Queensrche,
  Dire Straits,
  Megadeth,
  and other bands.      for protecting me against the noise of my computer.



                        Reporting bugs
                        --------------

 Bug-reports are wellcome (to me and Chris Pugmire). It can not be guaranteed
 that they will be fixed. You should report bugs, that seem to be unique to
 GLE 32 and GLE for OS/2, to me. Please include a complete description of the
 bug, the version of GLE and the GLE files with data.

  

  Axel Rohde, Feb. 28. 1995 

  email: rohde@physik.uni-kiel.d400.de

