![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to cref.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / dist / man / v3 / man1|
Return to cref.1 CVS log | Up to [Research Unix] / researchv10dc / dist / man / v3 / man1 |
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.