
		32 bit DOS version of GLE by Axel Rohde
		---------------------------------------

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 g
	
			      by Axel Rohde
________________________________________________________________________________

 The source-Code of GLE is free and available from many FTP-sites
 (e.g. nic.funet.fi, ftp.informatik.uni-stuttgart.de, tui.marc.cri.nz).
 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 are using a 32-bit DOS-extender called
 GO32 by the same author. Therefore, GLE 32 runs only on Intel i386SX and
 above/compatible CPUs. GO32 comes with a co-processor-emulator for those
 machines without a floating point processor. Real-mode co-processor-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.


		       Properties of GLE 32
		       --------------------

 - 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 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 flicker-free high resolution modes.

   

			    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_TOPfont -> d:/gle32/font. Don't forget
   the slash as last character of GLE_TOP's value. 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
   numeric-processor installed, the co-processor-emulator EMU387, must be in
   the path-environment. 

     set GLE_TOP=d:/gle32/              <- don't omit the last slash!
     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 

   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 wrong installed graphics-mode can DESTROY your MONITOR and/or Graphics-
   board) if the 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. (MY Monitor has a horizontal frequency of 64 kHz and
   supports a resolution of 1024x768 with a refresh rate up to 80Hz.)
   If it is possible, 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 at all !!!
   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) Makefmt is missing because DJGPP's Library lacks ecvt().
      Both programs are used to calculate vector-fonts in the Unix-version
      of the source-distribution. Both programs are NOT included in the
      16-bit DOS-version of GLE, too. This package includes ALL (allready
      calculated) fonts from the Unix-source distribution. They were calculated
      under Linux, a free Unix-implementation for i386-PC's and higher. Since a
      few months, there exists an archive with my patches (at the ftp-sites
      sunsite.unc.edu and nic.funet.fi) to compile GLE 3.3b under Linux. 
   3) 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.


		Changes from GLE32 version 3.3b to version 3.3g
		-----------------------------------------------
   1) The online help of gle_vga works now.
   2) The right mouse button works now (pen-up).
   3) The DVI-drivers are now a little bit more testet...I tested them
      with a HP-Deskjet 500. I changed some code to protect gle_dvip from
      writing to LPT1 (handshaking isn't possible). Instead, it should write
      to a file and *you* should copy this file to your printer. There are
      some batches that do this task automagically. I added a batch-file
      called WPgle, to add a tiff-image to postscript output. It *should* work.
   4) Control-s from within gle_vga does now a shell-to-dos. DJGPP's library
      does a shell-to-hell by calling system(""). This was eliminated by
      using system(getenv("COMSPEC"))....


		Changes from GLE32 version 3.3g to version 3.3ga
		------------------------------------------------
   1) I fixed bugs in the editors of gle_vga (screen corruption when pressing
      return at the end of both file and screen) and surf_vga ( same as in
      gle_vga and crash, when typing characters behind column 79.
   2) I added the code to draw *nice* shades and grids ( see dvifill.gle
      and wall.gle ) to the VGA driver. These patterns look very similar
      to the output of the Postscript driver. However, they can not be exact
      since only 8x8 bitmaps can be used to define the patterns. Their
      appearence is dependend from the chosen resolution.
   3) SURF_VGA displays now error messages an draws markers (only circles
      are visible as in the 16-bit DOS release). GLE_VGA crashed when
      pressing F9 before F1 or F10 or whatever.


			     Other News
			     ----------
   Are you using OS/2? I 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.
   However, 'gle_pm' (or OS/2) is not as fast as GLE 32 under DOS with good
   harddisk cacheing. There is no mouse support yet. 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. The Linux binaries use not really new shared libraries
   and may not run on a *new* distribution. I consider, a Linux user is able
   to recompile the source, so it is not a problem (I don't like to upgrade
   Linux every three months :-). 


			      Suggestions
			      -----------
   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 non-postscript-capable devices. It can convert
   Postscript to various Bitmap-Formats. The current version is 2.6.1.
   It runs on i386 processors and higher using the Watcom 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 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 complete Postscript documentation of GLE 3.2 is in the directory
   gle32\postscri.doc. In this distribution, the PS-files are already patched
   into a Ghostscript-printable state. I tried to print them on a PS printer
   and it worked.

  
			      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.

 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.


 Bug-reports are wellcome (to me and Chris Pugmire). It can not be guaranteed
 that they can be fixed. Include a complete description of the bug, the
 version of GLE and the GLE files with data.


	Axel Rohde, 18.7.94,    email: rohde@physik.uni-kiel.d400.de

	Chris Pugmire's email adress: in%"srghcxp@grv.dsir.govt.nz" 
					srghcxp@grv.dsir.govt.nz
