Annotation of gforth/INSTALL, revision 1.8

1.7       anton       1: You need gcc version 2.0 or later to compile gforth.
1.1       anton       2: 
1.5       anton       3: First, type
1.3       anton       4: 
1.8     ! anton       5: ./configure
1.1       anton       6: 
1.4       pazsan      7: configure has the following useful parameters:
1.8     ! anton       8:   --enable-force-reg      Use explicit register declarations if they appear in
        !             9:                           the machine.h file. This can cause a good speedup,
        !            10:                           but also incorrect code with some gcc versions on
        !            11:                           some processors (default disabled).
        !            12:   --enable-direct-threaded      Force direct threading. This may not work on
        !            13:                                 some machines and may cause slowdown on others.
        !            14:                                 (default processor-dependent)
        !            15:   --enable-indirect-threaded    Force indirect threading. This can cause a
        !            16:                                 slowdown on some machines.
        !            17:                                 (default processor-dependent)
        !            18:   --with-debug     specifies option -g to compile with debug info (default)
        !            19:    --without-debug  omits the -g switch and creates smaller images on
        !            20:                     machines where strip has problems with gcc style
        !            21:                     debugging informations.
        !            22:   --help: tells you about other parameters.
1.1       anton      23: 
1.5       anton      24: 
1.4       pazsan     25: Now type
1.2       anton      26: 
1.5       anton      27: make
                     28: 
                     29: If your make has trouble with the Makefile, "make gforth" might work.
1.2       anton      30: 
1.4       pazsan     31: If your installed gcc isn't called "gcc" (eg. called "gcc-2.6.1"), type
1.1       anton      32: 
1.7       anton      33: make GCC=<whatever you call your gcc>
1.4       pazsan     34: 
                     35: instead.
1.6       anton      36: 
1.7       anton      37: Now you can check whether your shiny new Forth system works. Say
                     38: 
                     39: make test
                     40: 
1.6       anton      41: To make the documentation, type
                     42: 
                     43: make -k gforth.info gforth.ps html
1.7       anton      44: 
                     45: If everything is allright, you may want to install gforth. Type
                     46: 
                     47: make install
                     48: 
                     49: You may want to override the defaults for the directories. E.g., if
                     50: you want to install in the /gnu hierarchy instead of in the default
                     51: /usr/local hirarchy, say
                     52: 
                     53: make install prefix=/gnu
                     54: 
                     55: Alternatively, you can specify the prefixes with configure.

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