Diff for /gforth/INSTALL.DOS between versions 1.1 and 1.5

version 1.1, 1995/12/11 13:15:18 version 1.5, 1996/12/06 20:23:03
Line 1 Line 1
 You need DJ Delorie's port of GCC to DOS (DJGPP) to compile Gforth. DJGPP  MS-DOS:
 provides a DOS extender (GO32) that allows to use the 32-bit features of  
 the 80386, but on the other hand it requires at least an 386.  You need DJ Delorie's port of GCC to DOS (DJGPP 2.0) to compile
   Gforth. DJGPP provides a DPMI client that allows to use the 32-bit
 Gforth hasn't been tested with EMX, using EMX will require some changes in  features of the 80386, but on the other hand it requires at least a
 the console IO part. If you don't want to install this package (quite  386. A DPMI host is also part of the DJGPP 2.0 package, this is
 large), look for a binary distribution of Gforth for DOS. You must have a  required if you don't have a DPMI host yourself (Windows/OS/2/Linux
 version of GNU make, because DOS make programs are likely to have problems  DOS-box, Quemm or others).
 with the Makefile. If you want to change Gforth, you may need GNU m4, too.  
   OS/2:
   
   You need EMX 0.9c to compile Gforth. The EMX package provides all
   necessary Unix-like tools, tty and signal handling.
   
   If you don't want to install the DJGPP or EMX package (quite large),
   look for a binary distribution of Gforth for DOS or OS/2. You also
   must have a version of GNU make, because DOS/OS/2 make programs are
   likely to have problems with the Makefile. If you want to change
   Gforth, you may need GNU m4, too. Because DJGPP provides use of long
   filenames under Windows 95, you should unpack the gforth package with
   a Windows-95-aware archiver (those from DJGPP or the Cygnus
   Win32-package come in mind), because otherwise gforth will not find
   the necessary files. With MS-DOS versions prior 7.0 or DR-DOS, these
   names are cut due to the 8.3 rule. This might confuse DJGPP 2.0's
   make, you could use DJGPP 1.x's make instead. Gforth 0.2.0 hasn't been
   compiled with a MS-DOS prior 7.0.
   
   Compiling under DOS or OS/2 has a number of quirks, and if it doesn't
   compile out of the box, you should know what you do. I therefore
   discourage unexperienced users to compile gforth themselfes. There's a
   binary package for it anyway.
   
 If you don't bother and want to make it yourself, type  If you don't bother and want to make it yourself, type
   
 configure  configure
   
 There are no options for configure, because DOS can't execute a real  configure has the following useful parameters:
 configure script, all the configuring stuff is done on a real operating    --enable-force-reg      Use explicit register declarations if they appear in
 system. If you want to change something (e.g. use FORCE_REG or                            the machine.h file. This can cause a good speedup,
 DIRECT_THREADED), you have to change the makefile yourself. Be careful! DOS                            but also incorrect code with some gcc versions on
 command line arguments are limited to an overall size of 126 bytes, so                            some processors (default disabled).
 adding a new define in the makefile will make it too long. In this case add    --enable-direct-threaded      Force direct threading. This may not work on
 the define at the beginning of machine.h instead, or create a file                                  some machines and may cause slowdown on others.
 containing all extra options, and add @<filename> to the defines (move the                                  (default disabled)
 -DDEFAULTPATH-define into this file, and it will fit into the command line).    --enable-indirect-threaded    Force indirect threading. This can cause a
                                   slowdown on some machines.
                                   (default enabled)
   
 After covering all inconveniences, type  After covering all inconveniences, type
   
 make gforth  
   
 and after this finishes, type  
   
 make  make
   
 We apologize for the inconveniences, we did not invent the 640k limit  
 that prevents doing make straight forward. You may run out of memory  
 anyway, because GCC eats up lots of it while compiling engine.c. Keep  
 enough space free on your harddisk to allow GCC to swap.  
   
 If you want to add some defines like -DFORCE_REG, type  
   
 make gforth XDEFINES=-DFORCE_REG  
   
 instead.  
   
 Now you can check whether your shiny new Forth system works. Say  Now you can check whether your shiny new Forth system works. Say
   
 make test  make test
Line 57  command lines. Line 66  command lines.
   
 Add the following entry to your Autoexec.bat:  Add the following entry to your Autoexec.bat:
   
 SET GFORTHPATH=<your gforth source directory>:.  SET GFORTHPATH=<your gforth source directory>;.
   
 Use / instead of \ in your gforth source directory.  Another problem  Use / instead of \ in your gforth source directory. Gforth now uses
 is, that Gforth uses : as path separator, and DOS pathes may look like  ';' as path separator, so you won't have problems with DOS pathes that
 D:/gforth.  Sorry, there is no workaround for this now.  may contain ':', which is the default path separator in Unix.
   
 For paper documentation, print gforth.ps (a Postscript file (300dpi  For paper documentation, print gforth.ps (a Postscript file (300dpi
 fonts, i.e., it works, but does not produce best quality on better  fonts, i.e., it works, but does not produce best quality on better
Line 71  make gforth.dvi Line 80  make gforth.dvi
   
 and print the resulting file gforth.dvi (you need TeX for that! But  and print the resulting file gforth.dvi (you need TeX for that! But
 with TeX you can print it even if you don't have a Postscript printer  with TeX you can print it even if you don't have a Postscript printer
 nor Ghostscript).  You could be able to make a html version of the  nor Ghostscript).  You could be able to make a HTML version of the
 document, but AFAIK there is no texi2html for DOS available, as there  document, but AFAIK there is no texi2html for DOS available, as there
 is no perl available.  is no perl available.

Removed from v.1.1  
changed lines
  Added in v.1.5


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>