Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

10.0;crefs (cross_reference_symbols), revision 1.0, 88/01/21
crefs (cross_reference_symbols) -- Cross-reference symbols in a file.
usage:  crefs [-f] [pathname ...] [options]



DESCRIPTION
     crefs produces a cross-referenced list of the symbols in each of the
     named files, and writes each list to standard output. A symbol is a
     string of letters, digits, underscores, and dollar signs and must begin
     with a letter. The list contains every symbol in the file in alphabetical
     order, followed by the numbers of the lines in which the symbol appears.

     Symbols of more than 32 characters are truncated.

ARGUMENTS
     pathname  (optional)
                    Specify input file.  Multiple pathnames and wildcarding
                    are permitted: separate names with blanks.

                    Default if omitted:  read text from standard input

OPTIONS
     If you do not specify the -f option, crefs treats uppercase and lowercase
     letters as different characters, and places uppercase letters before
     lowercase letters in the alphabetical sort.

     -f        Treat all input text as lowercase while cross-referencing.

     -k key_file
               Only the words listed in key_file are cross-referenced.  List
               these words one per line.

EXAMPLES
     To find all occurrences of certain variables in the program cycle, type:

     $ crefs cycle


     You can also use crefs in conjunction with other commands to produce more
     refined results.  For instance:


     $ crefs cycle | tee cycle.all | fpat wheel spoke axle >cycle.some


     The output file cycle.all contains a list of all the symbols in the
     program, with references to the line containing them.  The output file
     cycle.some contains only the lines with references to the three variables
     named: wheel, spoke, and axle.

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