NAME

lxref − lisp cross reference program

SYNOPSIS

lxref [ −n ] xref-file ...  [ −a source-file ... ]

DESCRIPTION

Lxref reads cross reference files written by the lisp compiler liszt and prints a cross reference listing on the standard output. 

With its −x option, liszt creates a cross reference file during compilation.  Cross reference files usually end in ‘.x’; consequently, lxref appends a ‘.x’ to the filenames given if necessary. 

Lxref takes two options, which are described below. 

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 second option follows the xref-files (cross reference files written by lisp) on the command line.  The −a sourcefile option causes lxref to put limited cross reference information in the sources named.  Lxref scans the source and when it comes across a definition of a function (that is, a line beginning with ‘(def’), it precedes that line with a list of the functions that call this function, written as a comment preceded by ‘;..’.  All existing lines beginning with ‘;.. ’ will be removed from the file.  A line beginning with ‘;.-’ in a source file disables this annotation process from this point on until a ‘;.+’ is seen (however, lxref will continue to delete lines beginning with ‘;.. ’). After it has completed the annotation, lxref changes the name of the original file from ‘foo.l’ to ‘#.foo.l’. Lxref names the new file with annotation ‘foo.l’.

SEE ALSO

lisp(1), liszt(1)
 

4th Berkeley Distribution  —  April 29, 1985