Return to INSTALL.DOS CVS log

Up to [gforth] / gforth

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.