Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

lxref(1) [bsd man page]

LXREF(1)						      General Commands Manual							  LXREF(1)

NAME
lxref - lisp cross reference program SYNOPSIS
lxref [ -N ] xref-file ... [ -a source-file ... ] DESCRIPTION
Lxref reads cross reference file(s) written by the lisp compiler liszt and prints a cross reference listing on the standard output. Liszt will create a cross reference file during compilation when it is given the -x switch. Cross reference files usually end in `.x' and conse- quently lxref will append a `.x' to the file names given if necessary. The first option to lxref is a decimal integer, N, which sets the ignorelevel. If a function is called more than ignorelevel times, the cross reference listing will just print the number of calls instead of listing each one of them. The default for ignorelevel is 50. The -a option causes lxref to put limited cross reference information in the sources named. lxref will scan the source and when it comes across a definition of a function (that is a line beginning with `(def' it will preceed that line with a list of the functions which call this function, written as a comment preceeded by `;.. ' . All existing lines beginning with `;.. ' will be removed from the file. If the source file contains a line beginning `;.-' then this will disable this annotation process from this point on until a `;.+' is seen (how- ever, lines beginning with `;.. ' will continue to be deleted). After the annoation is done, the original file `foo.l' is renamed to `#.foo.l'" and the new file with annotation is named `foo.l' AUTHOR
John Foderaro SEE ALSO
lisp(1), liszt(1) BUGS
4th Berkeley Distribution April 29, 1985 LXREF(1)

Check Out this Related Man Page

CXREF(1)						      General Commands Manual							  CXREF(1)

NAME
cxref - cross reference C source files SYNOPSIS
cxref [ -FSCcfis ] [ -w width ] [files] DESCRIPTION
Cxref reads the named C source files and produces on the standard output a cross reference of all the identifiers and constants in the files. Constants are integer constants (12, 0421, 0x1A), floating point constants (123.45, 0.2e-4), string constants ("this is a string "), and character constants ('a', '33'). Identifiers, character constants, and string constants are sorted lexicographically, i.e. according to the machine collating sequence (7-bit ASCII on the Vax or the Pyramid). Integer and floating point constants are sorted numerically. The trailing 'l' or 'L' on long integer constants will not show up in the output listing. If no files are named, cxref reads the standard input. For multiple files, the argument "-" (a single dash) indicates that the standard input should be read at that point. If arguments are given, they must come before any file names. Cxref recognizes the following arguments: -F Fold case in comparison. By default, case is distinct in comparison of identifiers and string and character constants. (cxref simply passes the "-F" option on to sort(1) as "-f".) -S Cross reference all files separately. The default action is to cross reference all named files together. -c Leave character constants out of the cross reference listing. -f Leave floating point constants out of the cross reference listing. -i Leave integer constants out of the cross reference listing. -s Leave string constants out of the cross reference listing. -C Leave all constants, character, string, integer, and floating point, out of the cross reference listing. By default, all types of constants are included in the cross reference. -w width Make the output be width columns wide. The output width will never be less than 51 or more than 132 columns. Cxref silently adjusts incorrect settings to the nearest allowable setting. If no width is specified, the output will default to 80 columns wide. Cxref does not include #include files, or expand macro definitions. Files named in #include lines can be listed on the command line if they should also be cross referenced. If a quoted string has an escaped newline in it (see ``The C Programming Language'', page 181, or Section 2.5 of the C Reference Manual), it will show up inside the string in the output listing as N. This is to make it visible to the programmer, and to keep the various fil- ters which Cxref uses to actually do the work from getting terribly confused. Cxref is best run in the background, with its output redirected into a file or the line printer spooler lpr(1), since it reads all the named files, using sort(1) as an intermediate pass. The sorting can take time which the user can probably put to more productive use. DIAGNOSTICS
Self explanatory. BUGS
Systems running UNIX 4.0 and later already have a program named cxref. Therefore, on those systems, this program should be renamed. Cxref does not do any formatting on its output (other than to insure that it writes the proper number of columns), so it should probably be run piping its output into pr(1). Floating point constants are converted to a common format for sorting, therefore they may appear in the output in a format different from (but numerically equivalent to) their form in the original source code. SEE ALSO
lex(1), lpr(1), pr(1), sort(1) FILES
/tmp/cxr.$$.* temporary files for integer and floating point contstants. Cxref removes these files when it is through. AUTHOR
Arnold Robbins School of Information and Computer Science Georgia Institute of Technology Atlanta, Geogia 30332 UUCP: gatech!arnold CSNET: arnold@gatech ARPANET: arnold%gatech.csnet@csnet-relay.arpa Copyright (c) 1984 by Arnold Robbins. All rights reserved. This program may not be sold, but may be distributed provided this notice is included. Georgia Tech CXREF(1)
Man Page