Annotation of gforth/INSTALL.DOS, revision 1.3
1.2 pazsan 1: You need DJ Delorie's port of GCC to DOS (DJGPP 2.0) to compile
2: Gforth. DJGPP provides a DPMI client that allows to use the 32-bit
3: features of the 80386, but on the other hand it requires at least a
4: 386. A DPMI host is also part of the DJGPP 2.0 package, this is
5: required if you don't have a DPMI host yourself (Windows/OS/2/Linux
6: DOS-box, Quemm or others).
1.1 pazsan 7:
8: Gforth hasn't been tested with EMX, using EMX will require some changes in
1.2 pazsan 9: the console IO part. If you don't want to install the DJGPP package (quite
1.1 pazsan 10: large), look for a binary distribution of Gforth for DOS. You must have a
11: version of GNU make, because DOS make programs are likely to have problems
12: with the Makefile. If you want to change Gforth, you may need GNU m4, too.
13:
14: If you don't bother and want to make it yourself, type
15:
16: configure
17:
1.2 pazsan 18: configure has the following useful parameters:
19: --enable-force-reg Use explicit register declarations if they appear in
20: the machine.h file. This can cause a good speedup,
21: but also incorrect code with some gcc versions on
22: some processors (default disabled).
23: --enable-direct-threaded Force direct threading. This may not work on
24: some machines and may cause slowdown on others.
25: (default processor-dependent)
26: --enable-indirect-threaded Force indirect threading. This can cause a
27: slowdown on some machines.
28: (default processor-dependent)
1.1 pazsan 29:
30: After covering all inconveniences, type
31:
32: make
33:
34: Now you can check whether your shiny new Forth system works. Say
35:
36: make test
37:
38: You can run some benchmarks with
39:
40: make bench
41:
42: and compare them with the results in Benchres and in the manual.
43:
44: Don't try to do "make install", it won't work, either. It is not possible to
45: "make dist" or "make bindist", too, because of the limitations of DOS
46: command lines.
47:
48: Add the following entry to your Autoexec.bat:
49:
1.3 ! pazsan 50: SET GFORTHPATH=<your gforth source directory>;.
1.1 pazsan 51:
1.3 ! pazsan 52: Use / instead of \ in your gforth source directory. Gforth now uses
! 53: ';' as path separator, so you won't have problems DOS pathes that may
! 54: contain ':', which is the default path separator in Unix.
1.1 pazsan 55:
56: For paper documentation, print gforth.ps (a Postscript file (300dpi
57: fonts, i.e., it works, but does not produce best quality on better
58: printers)), or say
59:
60: make gforth.dvi
61:
62: and print the resulting file gforth.dvi (you need TeX for that! But
63: with TeX you can print it even if you don't have a Postscript printer
64: nor Ghostscript). You could be able to make a html version of the
65: document, but AFAIK there is no texi2html for DOS available, as there
66: is no perl available.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>