Return to man1 CVS log

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

Annotation of researchv10no/cmd/f2c/doc/man1, revision 1.1

1.1     ! root        1: From mwm Tue Jan 10 14:56:38 EST 1989
        !             2: To: dmg
        !             3: Subject: newer man
        !             4: 
        !             5: 
        !             6:        Dave,
        !             7: 
        !             8:        This is the latest version of the man page.  It includes some things
        !             9: (like -c, -L) which aren't implemented.  But it will give you a better picture
        !            10: of the files generated by f2c.
        !            11: 
        !            12:        f2c -- Fortran 77 to C tranlator
        !            13: 
        !            14: ENVIRONMENT VARIABLES
        !            15:        f2cdebug -- Holds filename for diagnostic output.  This only matters
        !            16:                when the debugging switch has been given on the command line.
        !            17: 
        !            18: USER FILES
        !            19:        .f -- Fortran 77 source files
        !            20:        f2c.h -- Standard include file for the resulting C code
        !            21: 
        !            22: SYSTEM FILES
        !            23:        raw_data -- Holds unordered, untyped initializers generated by DATA
        !            24:                statements.  This file will be sorted and copied into
        !            25:                init_file.
        !            26:        init_file -- Holds the untyped initializers generated by Fortran
        !            27:                DATA statements.  This is zeroed for each function in the
        !            28:                input.
        !            29:        c_functions -- Holds all translated functions.  After the entire
        !            30:                input file has been processed, the table of constant values
        !            31:                gets prepended to this file; the result is the final
        !            32:                product, contained in c_output.
        !            33:        c_output -- Holds the translated C code.
        !            34:        p1_file -- Contains an intermediate form of the Fortran file.  This
        !            35:                p1_file.BAK for debugging.
        !            36:        p1_file.BAK -- Holds a copy of the p1 file for the previous
        !            37:                function.  This is useful in debugging because p1_file is
        !            38:                zeroed immediately after a function is tranlated.
        !            39: 
        !            40: COMMAND LINE OPTIONS
        !            41:        -o <filename> -- Write all output to the given filename.  If many
        !            42:                source files are input, they will be appended to this file
        !            43:                (does this make sense? No, make it only useful for one; the
        !            44:                default will be to write to infile.c)
        !            45:        -w66 -- Suppress warnings about any non-Fortran 66 features used.
        !            46:        -w -- Suppress all warnings.
        !            47:        -66, -6 -- Generate an error when a generic function (f77 feature) is
        !            48:                used.  Also generate an error when an extension to Fortran
        !            49:                77 is used (hex/oct/bin constant, automatic/static/double
        !            50:                complex types).
        !            51:        -d -- Set debug flag
        !            52:        -1, -onetrip -- perform each DO loop at least once
        !            53:        -I2 -- use shorts for integers, logicals
        !            54:        -I4 -- use longs for integers, logicals
        !            55:        -Is -- use short subscripts on arrays
        !            56:        -U -- don't convert all uppercase to lowercase
        !            57:        -u -- make the default variable type undefined
        !            58:        -O<#> -- use <#> register variables [NOT IMPLEMENTED]
        !            59:        -C -- Check that array subscripts lie within bounds at runtime
        !            60:        -Nq -- Set the max number of equivalences
        !            61:        -Nx -- Set the max number of externs
        !            62:        -Ns -- Set the max number of statement numbers
        !            63:        -Nc -- Set the max number of control constructs (loops, IF-THEN-ELSE)
        !            64:        -Nn -- Set the max number of identifiers (hash table size)
        !            65:        -c -- include the original Fortran in the output.
        !            66:        -L -- omit unreferenced labels
        !            67: 
        !            68: 
        !            69: 
        !            70: From mwm Tue Jan 10 14:54:38 EST 1989
        !            71: To: dmg
        !            72: 
        !            73: f2c -- Fortran 77 to C translator
        !            74: 
        !            75: SWITCHES
        !            76:        May be invoked with the same switches as f77
        !            77: 
        !            78: FILES
        !            79:        - Fortran input files are given on the command line; these must have a
        !            80:          .f suffix
        !            81:        - Generated C code will appear in a file called   c_output   in the
        !            82:          current working directory
        !            83:        - Several intermediate files are generated, and not removed.  These
        !            84:          are:
        !            85:                c_functions -- first copy of the generated C code, minus the
        !            86:                               table of constant values
        !            87:                expr_file -- useless, old data
        !            88:                init_file -- holds static initializations on a function by
        !            89:                             function basis
        !            90:                p1_file -- function by function intermediate file, only
        !            91:                           readable using the pfilter.awk script in
        !            92:                           /usr/mwm/f2c
        !            93:                p1_file.BAK -- same as above, useful for debugging since
        !            94:                               p1_file is always zeroed on termination
        !            95: 
        !            96:        - Every generated C file begins with '#include "f2c.h"'; this can be
        !            97:          found in /usr/mwm/f2c/f2c.h
        !            98:        - f2c calls the program /usr/mwm/f2c/f2cpass1 - this is hardcoded
        !            99:          right now.
        !           100: 
        !           101: ENVIRONMENT
        !           102:        - When environment variable   f2cdebug   is nonempty, debugging
        !           103:          output will be written to that filename.
        !           104: 

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