version 1.1, 1995/12/11 13:15:18
|
version 1.6, 1997/02/16 20:51:05
|
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. |
|
|
|
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 |
|
|
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 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 71 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. |