Enter your search terms Submit search form
	Web pdp-10.trailing-edge.com

.RV gjb 1/9/78 DoD/fm
.th NCREF I  12/7/76
.sh NAME
ncref \*-  C language program function cross-reference
.sh SYNOPSIS
.bd ncref
[\fB-\fIn\fR]
file ...
.sh DESCRIPTION
.it Ncref
produces a printed cross-reference summary of all function
definitions and calls in the C language programs specified by \fIfile ...\fR .
.sp
.s3
The output shows the names of the source file(s) preceded by a number
in\ \fB()\fR and an alphabetical list of the functions present in these files.
Each function reference contains the file number in\ \fB()\fR,
a page number and the line number reference within that file.
The file, page and line number where the function is defined is followed by
a\ '\fB*\fR' tag.
All line and page numbers correspond to utilities which output
source files with 56 lines of code per page,
or which recognize form feeds.
.sp
.s3
The \fIfile\fR argument(s) specifies the source input file(s).
This argument must be  present.
The output is written to the standard output file.
.sp
The optional argument\ \fB\*-\fIn\fR  indicates that source file numbers
begin with \fIn\fR.
Files are numbered consecutively beginning with that number.
If omitted, the file numbers begin with \fB1\fR.
.sp
.s3
\fINcref\fR is intended to be most useful when used in conjunction
with source code listings produced by \fIlist (I)\fR or \fIpr (I)\fR
(with the new options),
and when using multi-files as input.
The input files should be listed in the same order as the source code
listings.
.s3
.sh "SEE ALSO"
list(I), pr(I) with  new options
.sp
.sp
.sh DIAGNOSTICS
\fINcref\fR will produce the following fatal error messages:
.s3
"no source file -ncref terminated"
.br
indicates no source file was present.
.s3
"source file xxx --open error"
.br
"error: xxx"
.br
indicates an illegal file.
.s3
"out of fnode space - ncref terminated"
.br
indicates that the number of functions in the
source files exceeded the number for which \fIncref\fR has allocated
function space.
.s3
"out of rnode space - ncref terminated
.br
indicates that the number of function references
in the source files exceeds that for which \fIncref\fR can dynamically
allocate core storage.
.sp
.sh AUTHOR
Christine Ware, Digital Equipment Corp.
.br
Geraldine J. Blazek, Dept. of Defense  (revision)