Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ lxref(1) — Ultrix/UWS 4.2 VAX

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

lisp(1)

liszt(1)

lxref(1)  —  VAX  —  Unsupported

Name

lxref − lisp cross reference program

Syntax

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

Description

The lxref command 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 precede that line with a list of the functions which call this function, written as a comment preceded 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 annotation is done, the original file named ‘foo.l’ is renamed to ‘#.foo.l’ and the new file with annotation is named ‘foo.l’

See Also

lisp(1), liszt(1)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026