Research V4 development

Work on file man/man1/cref.1

Co-Authored-By: Dennis Ritchie <dmr@research.uucp>
Synthesized-from: v4

diff --git a/man/man1/cref.1 b/man/man1/cref.1
new file mode 100644 (file)
index 0000000..52dac33
--- /dev/null
+++ b/man/man1/cref.1
@@ -0,0 +1,141 @@
+.th CREF I 2/5/73
+.sh NAME
+cref  \*-  make cross reference listing
+.sh SYNOPSIS
+.bd cref
+[
+.bd \*-acilostux123
+] name ...
+.sh DESCRIPTION
+.it Cref
+makes a cross reference listing
+of program files in assembler or C format. The files
+named as arguments in the command
+line are searched for symbols 
+in the appropriate syntax.
+.s3
+The output report is in four columns:
+.nf
+.s3
+(1)    (2)     (3)     (4)
+symbol file    see     text as it appears in file
+               below
+.s3
+.fi
+.it Cref
+uses either an
+.it ignore
+file or an
+.it only
+file.
+If the
+.bd \*-i
+option is given, it will take the next
+available argument to be an
+.it ignore
+file name; if the
+.bd \*-o
+option is given, the next
+available argument will be taken as an
+.it only
+file name.
+.it Ignore
+and
+.it only
+files should be lists of symbols separated by new lines.
+If an
+.it ignore
+file is given, all the symbols in that file
+will be ignored in columns (1) and (3) of the output.
+If an
+.it only
+file is given, only symbols appearing in that
+file will appear in column (1).
+Only one of the options
+.bd \*-i
+or
+.bd \*-o
+may be used.
+The default setting
+is
+.bd \*-i.
+Assembler predefined symbols or C keywords are ignored.
+.s3
+The
+.bd \*-s
+option causes current symbols to be
+put in column 3.
+In the assembler, the current symbol
+is the most recent name symbol;
+in C, the current function name.
+The
+.bd \*-l
+option causes the line number within the file
+to be put in column 3.
+.s3
+The
+.bd \*-t
+option causes the next available argument
+to be used as the name
+of the intermediate temporary
+file (instead of /tmp/crt??).
+The file is created and
+is not removed at the end of the process.
+.s3
+Options:
+.s3
+.lp +5 3
+\fBa\fR        assembler format (default)
+.lp +5 3
+\fBc\fR        C format input
+.lp +5 3
+\fBi\fR        use
+.it ignore
+file (see above)
+.lp +5 3
+\fBl\fR        put line number in col. 3 (instead of current symbol)
+.lp +5 3
+\fBo\fR        use
+.it only
+file (see above)
+.lp +5 3
+\fBs\fR        current symbol in col. 3 (default)
+.lp +5 3
+\fBt\fR        user supplied temoprary file
+.lp +5 3
+\fBu\fR        print only symbols that occur exactly once
+.lp +5 3
+\fBx\fR        print only C external symbols
+.lp +5 3
+\fB1\fR        sort output on column 1 (default)
+.lp +5 3
+\fB2\fR        sort output on column 2
+.lp +5 3
+\fB3\fR        sort output on column 3
+.s3
+.i0
+.sh FILES
+.dt
+/tmp/crt??     temporaries
+.br
+/usr/lib/aign  default assembler 
+.it ignore
+file
+.br
+/usr/lib/cign  default C
+.it ignore
+file
+.br
+/usr/bin/crpost        post processor
+.br
+/usr/bin/upost post processor for
+.bd \*-u
+option
+.br
+/bin/sort      used to sort temporaries
+.br
+.s3
+.fi
+.sh "SEE ALSO"
+as(I), cc(I), sort(I)
+.sh BUGS