4.3BSD-UWisc/man/cat1/lxref.1

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



NAME
     lxref - lisp cross reference program

SYNOPSIS
     lxref [ -N ] xref-file ...  [ -a source-file ... ]

DESCRIPTION
     _L_x_r_e_f reads cross reference file(s) written by the lisp com-
     piler _l_i_s_z_t and prints a cross reference listing on the
     standard output.  _L_i_s_z_t will create a cross reference file
     during compilation when it is given the -x switch.  Cross
     reference files usually end in `.x' and consequently _l_x_r_e_f
     will append a `.x' to the file names given if necessary.
     The first option to _l_x_r_e_f is a decimal integer, N, which
     sets the _i_g_n_o_r_e_l_e_v_e_l. If a function is called more than
     _i_g_n_o_r_e_l_e_v_e_l times, the cross reference listing will just
     print the number of calls instead of listing each one of
     them.  The default for _i_g_n_o_r_e_l_e_v_e_l is 50.

     The -a option causes _l_x_r_e_f to put limited cross reference
     information in the sources named.  _l_x_r_e_f will scan the
     source and when it comes across a definition of a function
     (that is a line beginning with `(_d_e_f' 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 `_f_o_o._l' is renamed to " `#._f_o_o._l'" and the
     new file with annotation is named `_f_o_o._l'

AUTHOR
     John Foderaro

SEE ALSO
     lisp(1), liszt(1)

BUGS












Printed 12/27/86         April 29, 1985                         1