Return to README CVS log

Up to [Research Unix] / researchv10no / cmd / f2c

Annotation of researchv10no/cmd/f2c/README, revision 1.1

1.1     ! root        1: Type "make" to check the validity of the f2c source and compile f2c.
        !             2: 
        !             3: On a PC, you may need to compile xsum.c with -DMSDOS (i.e., with
        !             4: MSDOS #defined).  If your system does not understand ANSI/ISO C
        !             5: syntax (i.e., if you have a K&R C compiler), compile xsum.c with
        !             6: -DKR_headers.  (Eventually this will also be required of the f2c
        !             7: source proper.)
        !             8: 
        !             9: On non-Unix systems where files have separate binary and text modes,
        !            10: you may need to "make xsumr.out" rather than "make xsum.out".
        !            11: 
        !            12: If (in accordance with what follows) you need to modify the makefile
        !            13: or any of the source files, first issue a "make xsum.out" (or, if
        !            14: appropriate, "make xsumr.out") to check the validity of the f2c source,
        !            15: then make your changes, then type "make f2c".
        !            16: 
        !            17: The file usignal.h is for the benefit of strictly ANSI include files
        !            18: on a UNIX system -- the ANSI signal.h does not define SIGHUP or SIGQUIT.
        !            19: You may need to modify usignal.h if you are not running f2c on a UNIX
        !            20: system.
        !            21: 
        !            22: Should you get the message "xsum0.out xsum1.out differ", see what lines
        !            23: are different (`diff xsum0.out xsum1.out`) and ask netlib to send you
        !            24: the files in question "from f2c/src".  For example, if exec.c and
        !            25: expr.c have incorrect check sums, you would send netlib the message
        !            26:        send exec.c expr.c from f2c/src
        !            27: 
        !            28: On some systems, the malloc and free in malloc.c let f2c run faster
        !            29: than do the standard malloc and free.  Other systems cannot tolerate
        !            30: redefinition of malloc and free.  If yours is such a system, you may
        !            31: either modify the makefile appropriately, or simply execute
        !            32:        cc -c -DCRAY malloc.c
        !            33: before typing "make".  Still other systems have a -lmalloc that
        !            34: provides performance competitive with that from malloc.c; you may
        !            35: wish to compare the two on your system.
        !            36: 
        !            37: On some BSD systems, you may need to create a file named "string.h"
        !            38: whose single line is
        !            39: #include <strings.h>
        !            40: you may need to add " -Dstrchr=index" to the "CFLAGS =" assignment
        !            41: in the makefile, and you may need to add " memset.o" to the "OBJECTS ="
        !            42: assignment in the makefile -- see the comments in memset.c .
        !            43: 
        !            44: For non-UNIX systems, you may need to change some things in sysdep.c,
        !            45: such as the choice of intermediate file names.
        !            46: 
        !            47: On some systems, you may need to modify parts of sysdep.h (which is
        !            48: included by defs.h).  In particular, for Sun 4.1 systems and perhaps
        !            49: some others, you need to comment out the typedef of size_t.  For some
        !            50: systems (e.g., IRIX 4.0.1 and AIX) it is better to add
        !            51: #define ANSI_Libraries
        !            52: to the beginning of sysdep.h (or to supply -DANSI_Libraries in the
        !            53: makefile).
        !            54: 
        !            55: Alas, some systems #define __STDC__ but do not provide a true standard
        !            56: (ANSI or ISO) C environment, e.g. do not provide stdlib.h .  If yours
        !            57: is such a system, then (a) you should complain loudly to your vendor
        !            58: about __STDC__ being erroneously defined, and (b) you should insert
        !            59: #undef __STDC__
        !            60: at the beginning of sysdep.h .  You may need to make other adjustments.
        !            61: 
        !            62: For some non-ANSI versions of stdio, you must change the values given
        !            63: to binread and binwrite in sysdep.c from "rb" and "wb" to "r" and "w".
        !            64: You may need to make this change if you run f2c and get an error
        !            65: message of the form
        !            66:        Compiler error ... cannot open intermediate file ...
        !            67: 
        !            68: On many systems, it is best to combine libF77 and libI77 into a single
        !            69: library, say libf2c, as suggested in "readme from f2c".  If you do this,
        !            70: then you should adjust the definition of link_msg in sysdep.c
        !            71: appropriately (e.g., replacing "-lF77 -lI77" by "-lf2c").
        !            72: 
        !            73: Some older C compilers object to
        !            74:        typedef void (*foo)();
        !            75: or to
        !            76:        typedef void zap;
        !            77:        zap (*foo)();
        !            78: If yours is such a compiler, change the definition of VOID in
        !            79: f2c.h from void to int.
        !            80: 
        !            81: For convenience with systems that use control-Z to denote end-of-file,
        !            82: f2c treats control-Z characters (ASCII 26, '\x1a') that appear at the
        !            83: beginning of a line as an end-of-file indicator.  You can disable this
        !            84: test by compiling lex.c with NO_EOF_CHAR_CHECK #defined, or can
        !            85: change control-Z to some other character by #defining EOF_CHAR to
        !            86: be the desired value.
        !            87: 
        !            88: Please send bug reports to [email protected] .  The old index file
        !            89: (now called "readme" due to unfortunate changes in netlib conventions:
        !            90: "send readme from f2c") will report recent changes in the recent-change
        !            91: log at its end; all changes will be shown in the "changes" file
        !            92: ("send changes from f2c").  To keep current source, you will need to
        !            93: request xsum0.out and version.c, in addition to the changed source
        !            94: files.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.