|
|
1.1 ! root 1: .\" Copyright (c) 1980, 1990 Regents of the University of California. ! 2: .\" All rights reserved. The Berkeley software License Agreement ! 3: .\" specifies the terms and conditions for redistribution. ! 4: .\" ! 5: .\" @(#)lxref.1 6.2 (Berkeley) 6/24/90 ! 6: .\" ! 7: .TH LXREF 1 "%Q" ! 8: .UC 4 ! 9: .SH NAME ! 10: lxref \- lisp cross reference program ! 11: .SH SYNOPSIS ! 12: .B lxref ! 13: [ ! 14: .B \-N ! 15: ] xref-file ... ! 16: [ ! 17: .B \-a ! 18: source-file ... ] ! 19: .SH DESCRIPTION ! 20: .I Lxref ! 21: reads cross reference file(s) written by the lisp compiler ! 22: .I liszt ! 23: and prints a cross reference listing on the standard output. ! 24: .I Liszt ! 25: will create a cross reference file during compilation when it is ! 26: given the ! 27: .B \-x ! 28: switch. ! 29: Cross reference files usually end in `.x' and consequently ! 30: .I lxref ! 31: will append a `.x' to the file names given if necessary. ! 32: The first option to ! 33: .I lxref ! 34: is a decimal integer, N, which sets the ! 35: .I ignorelevel. ! 36: If a function is called more than ! 37: .I ignorelevel ! 38: times, the cross reference listing will just print the number of calls ! 39: instead of listing each one of them. ! 40: The default for ! 41: .I ignorelevel ! 42: is 50. ! 43: .PP ! 44: The ! 45: .B \-a ! 46: option causes ! 47: .I lxref ! 48: to put limited cross reference information in the sources named. ! 49: .I lxref ! 50: will scan the source and when it comes across a definition of a function ! 51: (that is a line beginning with ! 52: .I "`(def'" ! 53: it will preceed that line with a list of the functions which call this ! 54: function, written as a comment preceeded by ! 55: .I "`;.. '". ! 56: All existing lines beginning with ! 57: .I "`;.. '" ! 58: will be removed from the file. ! 59: If the source file contains a line beginning ! 60: .I "`;.-'" ! 61: then this will disable this annotation process from this point on until a ! 62: .I "`;.+'" ! 63: is seen (however, lines beginning with ! 64: .I "`;.. '" ! 65: will continue to be deleted). ! 66: After the annoation is done, the original file ! 67: .I "`foo.l'" ! 68: is renamed to ! 69: .I `#.foo.l'" ! 70: and the new file with annotation is named ! 71: .I "`foo.l'" ! 72: .SH AUTHOR ! 73: John Foderaro ! 74: .SH SEE ALSO ! 75: lisp(1), ! 76: liszt(1) ! 77: .SH BUGS
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.