Return to cref.1 CVS log

Up to [Research Unix] / researchv10dc / dist / man / v3 / man1

Annotation of researchv10dc/dist/man/v3/man1/cref.1, revision 1.1

1.1     ! root        1: .pa 1
        !             2: .he 'CREF (I)'2/5/1973'CREF (I)'
        !             3: .fi
        !             4: .in16
        !             5: .ti 0
        !             6: NAME           cref  --  make cross reference listing
        !             7: .sp
        !             8: .fi
        !             9: .in16
        !            10: .ti 0
        !            11: SYNOPSIS       cref____ [ -soi____ ] name1 ...
        !            12: .sp
        !            13: .fi
        !            14: .in16
        !            15: .ti 0
        !            16: DESCRIPTION    CREF makes a cross reference listing
        !            17: of files in assembler format (see AS(I)).  The files
        !            18: named as arguments in the command
        !            19: line are searched for symbols (defined as a succession
        !            20: of alphabetics, numerics, '.', or '_', beginning with
        !            21: an alphabetic, '.', or '_').
        !            22: .sp
        !            23: The output report is in four columns:
        !            24: .nf
        !            25: .sp
        !            26: (1)    (2)     (3)     (4)
        !            27: symbol file    see     text as it appears in file
        !            28:                below
        !            29: .sp
        !            30: .fi
        !            31: The third column contains the line number in the file
        !            32: by default; the -s__ option
        !            33: will cause the most recent name symbol to appear there
        !            34: instead.
        !            35: .sp
        !            36: CREF uses either an ignore______ file or an only____ file.
        !            37: If the -i__ option is given, it will take the next
        !            38: file name to be an ignore______ file; if the -o__ option
        !            39: is given, the next file name will be taken as an only____ file.
        !            40: Ignore______ and only____
        !            41: files should be lists of symbols separated by new lines.
        !            42: If an ignore______ file is given, all the symbols in the file
        !            43: will be ignored in columns (1) and (3) of the output.
        !            44: If an only____ file is given, only symbols appearing in the
        !            45: file will appear in column (1), but column (3)
        !            46: will still contain the most recent name encountered.
        !            47: Only one of the options -i__ or
        !            48: -o__ may be used.
        !            49: The default setting
        !            50: is -i__;
        !            51: all symbols predefined in the assembler are ignored, except
        !            52: system call names, which are collected.
        !            53: .sp
        !            54: .fi
        !            55: .in16
        !            56: .ti 0
        !            57: FILES          Files t.0, t.1, t.2, t.3 are
        !            58: created (i.e. DESTROYED) in the working
        !            59: directory of anyone
        !            60: using cref____. This nuisance will be repaired soon.
        !            61: The output is left in file s.out_____ in the working directory.
        !            62: .sp
        !            63: /usr/lem/s.tab is the default ignore______ file.
        !            64: .sp
        !            65: .fi
        !            66: .in16
        !            67: .ti 0
        !            68: SEE ALSO       as(I)
        !            69: .sp
        !            70: .fi
        !            71: .in16
        !            72: .ti 0
        !            73: DIAGNOSTICS    "line too long" -- input line >131 characters
        !            74: .nf
        !            75: .sp
        !            76: "symbol too long" -- symbol >20 characters
        !            77: .sp
        !            78: "too many symbols" -- >10 symbols in line
        !            79: .sp
        !            80: "cannot open t.?" -- bug; see LEM
        !            81: .sp
        !            82: "cannot fork; examine t.out" -- can't start sort____
        !            83: .in 20
        !            84: .fi
        !            85: process; intermediate results are on files t.0___,
        !            86: t.1___,t.2___,t.3___.  These may be sorted independently
        !            87: and the results concatenated by the user.
        !            88: .sp
        !            89: .in 16
        !            90: "cannot sort" -- odd response from sort____; examine
        !            91: .in 20
        !            92: intermediate results, as above.
        !            93: .sp
        !            94: .in16
        !            95: .nf
        !            96: "impossible situation" -- system bug
        !            97: .sp
        !            98: "cannot open" file -- one of the input names
        !            99: .in 20
        !           100: .fi
        !           101: cannot be opened for reading.
        !           102: .in16
        !           103: .nf
        !           104: .sp
        !           105: .fi
        !           106: .in16
        !           107: .ti 0
        !           108: BUGS           The destruction of
        !           109: unsuspecting users' files should soon be fixed.
        !           110: A limitation that may eventually go away is the
        !           111: restriction to assembler language format. There
        !           112: should be options for FORTRAN, English, etc., lexical
        !           113: analysis.
        !           114: .sp
        !           115: File names longer than eight characters cause misalignment in
        !           116: the output if tabs are set at every eighth column.
        !           117: 
        !           118: It should
        !           119: write on the standard output, not s.out.

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