[gforth] / gforth / INSTALL.DOS  

gforth: gforth/INSTALL.DOS


1 : pazsan 1.2 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).
7 : pazsan 1.1
8 : pazsan 1.4 Gforth hasn't been tested with EMX, using EMX will require some
9 :     changes in the console IO part. For OS/2 EMX supports POSIX-style tty,
10 :     so it might just compile out of the box. If you don't want to install
11 :     the DJGPP package (quite large), look for a binary distribution of
12 :     Gforth for DOS. You also must have a version of GNU make, because DOS
13 :     make programs are likely to have problems with the Makefile. If you
14 :     want to change Gforth, you may need GNU m4, too. Because DJGPP
15 :     provides use of long filenames under Windows 95, you should unpack the
16 :     gforth package with a Windows-95-aware archiver (those from DJGPP come
17 :     in mind), because otherwise gforth will not find the necessary
18 :     files. There is no such problem when using MS-DOS prior 7.x.
19 : pazsan 1.1
20 :     If you don't bother and want to make it yourself, type
21 :    
22 :     configure
23 :    
24 : pazsan 1.2 configure has the following useful parameters:
25 :     --enable-force-reg Use explicit register declarations if they appear in
26 :     the machine.h file. This can cause a good speedup,
27 :     but also incorrect code with some gcc versions on
28 :     some processors (default disabled).
29 :     --enable-direct-threaded Force direct threading. This may not work on
30 :     some machines and may cause slowdown on others.
31 : pazsan 1.4 (default disabled)
32 : pazsan 1.2 --enable-indirect-threaded Force indirect threading. This can cause a
33 :     slowdown on some machines.
34 : pazsan 1.4 (default enabled)
35 : pazsan 1.1
36 :     After covering all inconveniences, type
37 :    
38 :     make
39 :    
40 :     Now you can check whether your shiny new Forth system works. Say
41 :    
42 :     make test
43 :    
44 :     You can run some benchmarks with
45 :    
46 :     make bench
47 :    
48 :     and compare them with the results in Benchres and in the manual.
49 :    
50 :     Don't try to do "make install", it won't work, either. It is not possible to
51 :     "make dist" or "make bindist", too, because of the limitations of DOS
52 :     command lines.
53 :    
54 :     Add the following entry to your Autoexec.bat:
55 :    
56 : pazsan 1.3 SET GFORTHPATH=<your gforth source directory>;.
57 : pazsan 1.1
58 : pazsan 1.3 Use / instead of \ in your gforth source directory. Gforth now uses
59 : pazsan 1.4 ';' as path separator, so you won't have problems with DOS pathes that
60 :     may contain ':', which is the default path separator in Unix.
61 : pazsan 1.1
62 :     For paper documentation, print gforth.ps (a Postscript file (300dpi
63 :     fonts, i.e., it works, but does not produce best quality on better
64 :     printers)), or say
65 :    
66 :     make gforth.dvi
67 :    
68 :     and print the resulting file gforth.dvi (you need TeX for that! But
69 :     with TeX you can print it even if you don't have a Postscript printer
70 :     nor Ghostscript). You could be able to make a html version of the
71 :     document, but AFAIK there is no texi2html for DOS available, as there
72 :     is no perl available.

CVS Admin

Powered by ViewCVS 1.0-dev
(Powered by ViewCVS)

ViewCVS and CVS Help