Diff for /gforth/INSTALL.DOS between versions 1.2 and 1.6

version 1.2, 1996/09/23 20:41:58 version 1.6, 1997/02/16 20:51:05
Line 1 Line 1
   MS-DOS:
   
 You need DJ Delorie's port of GCC to DOS (DJGPP 2.0) to compile  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. DJGPP provides a DPMI client that allows to use the 32-bit
 features of the 80386, but on the other hand it requires at least a  features of the 80386, but on the other hand it requires at least a
Line 5  features of the 80386, but on the other Line 7  features of the 80386, but on the other
 required if you don't have a DPMI host yourself (Windows/OS/2/Linux  required if you don't have a DPMI host yourself (Windows/OS/2/Linux
 DOS-box, Quemm or others).  DOS-box, Quemm or others).
   
 Gforth hasn't been tested with EMX, using EMX will require some changes in  OS/2:
 the console IO part. If you don't want to install the DJGPP package (quite  
 large), look for a binary distribution of Gforth for DOS. You must have a  You need EMX 0.9c to compile Gforth. The EMX package provides all
 version of GNU make, because DOS make programs are likely to have problems  necessary Unix-like tools, tty and signal handling.
 with the Makefile. If you want to change Gforth, you may need GNU m4, too.  
   Windows 95/Windows NT:
   
   You need the Cygnus Win32 package. This package currently is only in
   beta test, so expect bugs and quirks.
   
   If you don't want to install the DJGPP, CYGWIN32 or EMX package (quite
   large), look for a binary distribution of Gforth for DOS, Win32 or
   OS/2. You also must have a version of GNU make, because DOS/Win32/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 themselves. There's a
   binary package for it anyway.
   
   Compiling using CygWin32 works a bit better, but there are still
   quirks. The package allows to "mount" Windows directories under
   typical unix locations. E.g. I installed the package in E:\cygnus, and
   then I mount /usr, /usr/local and /bin with
   
   ./mount e:/cygnus /usr
   ./mount e:/cygnus/H-i386-cygwin32 /usr/local
   ./mount e:/cygnus/H-i386-cygwin32/bin /bin
   
   once. Each time I start CygWin32's bash, I set up the following variables:
   
   export TMPDIR=/usr/tmp
   export COMPILER_PATH=/usr/local/lib/gcc-lib/i386-cygwin32/cygnus-2.7.2-961023
   export LIBRARY_PATH="/usr/lib;/usr/local/lib"
   export C_INCLUDE_PATH=/usr/local/i386-cygwin32/include
   export GCC_DEFAULT_OPTIONS="-specs=$COMPILER_PATH/specs"
   export PATH=/bin:.:$PATH
   
   Write this into a script and source it in at each bash invocation.
   
   Because Windows doesn't know about interpreters and shell scripts, you
   must run them from bash with e.g. "bash ./configure" instead just
   typing "./configure".
   
   
 If you don't bother and want to make it yourself, type  If you don't bother and want to make it yourself, type
   
Line 22  configure has the following useful param Line 71  configure has the following useful param
                           some processors (default disabled).                            some processors (default disabled).
   --enable-direct-threaded      Force direct threading. This may not work on    --enable-direct-threaded      Force direct threading. This may not work on
                                 some machines and may cause slowdown on others.                                  some machines and may cause slowdown on others.
                                 (default processor-dependent)                                  (default disabled)
   --enable-indirect-threaded    Force indirect threading. This can cause a    --enable-indirect-threaded    Force indirect threading. This can cause a
                                 slowdown on some machines.                                  slowdown on some machines.
                                 (default processor-dependent)                                  (default enabled)
   
 After covering all inconveniences, type  After covering all inconveniences, type
   
Line 47  command lines. Line 96  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 for DOS and OS/2 (not for Cygwin32), so you
 D:/gforth.  Sorry, there is no workaround for this now.  won't have problems with DOS pathes that 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 61  make gforth.dvi Line 111  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.2  
changed lines
  Added in v.1.6


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