usr/man/cat1/lxref.0



LXREF(1)            UNIX Programmer's Manual             LXREF(1)


N\bNA\bAM\bME\bE
     lxref - lisp cross reference program

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     l\blx\bxr\bre\bef\bf [ -\b-N\bN ] xref-file ...  [ -\b-a\ba source-file ... ]

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     _\bL_\bx_\br_\be_\bf reads cross reference file(s) written by the lisp com-
     piler _\bl_\bi_\bs_\bz_\bt and prints a cross reference listing on the
     standard output.  _\bL_\bi_\bs_\bz_\bt will create a cross reference file
     during compilation when it is given the -\b-x\bx switch.  Cross
     reference files usually end in `.x' and consequently _\bl_\bx_\br_\be_\bf
     will append a `.x' to the file names given if necessary.
     The first option to _\bl_\bx_\br_\be_\bf is a decimal integer, N, which
     sets the _\bi_\bg_\bn_\bo_\br_\be_\bl_\be_\bv_\be_\bl. If a function is called more than
     _\bi_\bg_\bn_\bo_\br_\be_\bl_\be_\bv_\be_\bl times, the cross reference listing will just
     print the number of calls instead of listing each one of
     them.  The default for _\bi_\bg_\bn_\bo_\br_\be_\bl_\be_\bv_\be_\bl is 50.

     The -\b-a\ba option causes _\bl_\bx_\br_\be_\bf to put limited cross reference
     information in the sources named.  _\bl_\bx_\br_\be_\bf will scan the
     source and when it comes across a definition of a function
     (that is a line beginning with `(_\bd_\be_\bf' 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 `_\bf_\bo_\bo._\bl' is renamed to " `#._\bf_\bo_\bo._\bl'" and the
     new file with annotation is named `_\bf_\bo_\bo._\bl'

A\bAU\bUT\bTH\bHO\bOR\bR
     John Foderaro

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     lisp(1), liszt(1)

B\bBU\bUG\bGS\bS


Printed 7/9/88           April 29, 1985                         1