Copyright (c) 1980 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.

@(#)lxref.1 5.1 (Berkeley) 04/29/85

C 4 lxref - lisp cross reference program lxref [ -N ] xref-file ... [ -a source-file ... ] 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 consequently 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 (however, 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'"

John Foderaro lisp(1), liszt(1)