|
|
1.1 root 1: .th CREF I 2/5/73
2: .sh NAME
3: cref \*- make cross reference listing
4: .sh SYNOPSIS
5: .bd cref
6: [
7: .bd \*-acilostux123
8: ] name ...
9: .sh DESCRIPTION
10: .it Cref
11: makes a cross reference listing
12: of program files in assembler or C format. The files
13: named as arguments in the command
14: line are searched for symbols
15: in the appropriate syntax.
16: .s3
17: The output report is in four columns:
18: .nf
19: .s3
20: (1) (2) (3) (4)
21: symbol file see text as it appears in file
22: below
23: .s3
24: .fi
25: .it Cref
26: uses either an
27: .it ignore
28: file or an
29: .it only
30: file.
31: If the
32: .bd \*-i
33: option is given, it will take the next
34: available argument to be an
35: .it ignore
36: file name; if the
37: .bd \*-o
38: option is given, the next
39: available argument will be taken as an
40: .it only
41: file name.
42: .it Ignore
43: and
44: .it only
45: files should be lists of symbols separated by new lines.
46: If an
47: .it ignore
48: file is given, all the symbols in that file
49: will be ignored in columns (1) and (3) of the output.
50: If an
51: .it only
52: file is given, only symbols appearing in that
53: file will appear in column (1).
54: Only one of the options
55: .bd \*-i
56: or
57: .bd \*-o
58: may be used.
59: The default setting
60: is
61: .bd \*-i.
62: Assembler predefined symbols or C keywords are ignored.
63: .s3
64: The
65: .bd \*-s
66: option causes current symbols to be
67: put in column 3.
68: In the assembler, the current symbol
69: is the most recent name symbol;
70: in C, the current function name.
71: The
72: .bd \*-l
73: option causes the line number within the file
74: to be put in column 3.
75: .s3
76: The
77: .bd \*-t
78: option causes the next available argument
79: to be used as the name
80: of the intermediate temporary
81: file (instead of /tmp/crt??).
82: The file is created and
83: is not removed at the end of the process.
84: .s3
85: Options:
86: .s3
87: .lp +5 3
88: \fBa\fR assembler format (default)
89: .lp +5 3
90: \fBc\fR C format input
91: .lp +5 3
92: \fBi\fR use
93: .it ignore
94: file (see above)
95: .lp +5 3
96: \fBl\fR put line number in col. 3 (instead of current symbol)
97: .lp +5 3
98: \fBo\fR use
99: .it only
100: file (see above)
101: .lp +5 3
102: \fBs\fR current symbol in col. 3 (default)
103: .lp +5 3
104: \fBt\fR user supplied temoprary file
105: .lp +5 3
106: \fBu\fR print only symbols that occur exactly once
107: .lp +5 3
108: \fBx\fR print only C external symbols
109: .lp +5 3
110: \fB1\fR sort output on column 1 (default)
111: .lp +5 3
112: \fB2\fR sort output on column 2
113: .lp +5 3
114: \fB3\fR sort output on column 3
115: .s3
116: .i0
117: .sh FILES
118: .dt
119: /tmp/crt?? temporaries
120: .br
121: /usr/lib/aign default assembler
122: .it ignore
123: file
124: .br
125: /usr/lib/cign default C
126: .it ignore
127: file
128: .br
129: /usr/bin/crpost post processor
130: .br
131: /usr/bin/upost post processor for
132: .bd \*-u
133: option
134: .br
135: /bin/sort used to sort temporaries
136: .br
137: .s3
138: .fi
139: .sh "SEE ALSO"
140: as(I), cc(I), sort(I)
141: .sh BUGS
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.