LXREF(1)                                                              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 compiler _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  conse‐
       quently  _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
4th Berkeley Distribution       April 29, 1985                        LXREF(1)