6/14/1972                                               CREF (VI)





NAME            cref  --  make cross reference listing



SYNOPSIS        cref [ -soi ] name1 ...



DESCRIPTION     CREF makes a cross reference listing of files in

                assembler format (see AS(I)).  The files named as

                arguments in the command line are searched for

                symbols (defined as a succession of alphabetics,

                numerics, '.', or '_', beginning with an alpha-

                betic, '.', or '_').



                The output report is in four columns:



                (1)     (2)     (3)     (4)

                symbol  file    see     text as it appears in file

                                below



                The third column contains the line number in the

                file by default; the -s option will cause the

                most recent name symbol to appear there instead.



                CREF uses either an ignore file or an only file.

                If the -i option is given, it will take the next

                file name to be an ignore file; if the -o option

                is given, the next file name will be taken as an

                only file.  Either ignore or only files must be

                made by chash (q.v.).  If an ignore file is

                given, all the symbols in the file will be ig-

                nored in columns (1) and (3) of the output.  If

                an only file is given, only symbols appearing in

                the file will appear in column (1), but column

                (3) will still contain the most recent name en-

                countered.  Only one of the options -i or -o may

                be used.  The default setting is -i; all symbols

                predefined in the assembler are ignored, except

                system call names, which are collected.



FILES           Files t.0, t.1, t.2, t.3 are created (i.e. DE-

                STROYED) in the working directory of anyone using

                cref. This nuisance will be repaired soon.  The

                output is left in file s.out in the working di-

                rectory.



                /usr/lem/s.tab is the default ignore file.



SEE ALSO        chash(VI); as(I)



DIAGNOSTICS     "line too long" -- input line >131 characters



                "symbol too long" -- symbol >20 characters



                "too many symbols" -- >10 symbols in line



                "cannot open t.?" -- bug; see author



                "cannot fork; examine t.out" -- can't start sort

                    process; intermediate results are on files

                    t.0, t.1,t.2,t.3.  These may be sorted inde-

                    pendently and the results concatenated by the

                    user.



                "cannot sort" -- odd response from sort; examine

                    intermediate results, as above.



                "impossible situation" -- system bug



                "cannot open" file -- one of the input names

                    cannot be opened for reading.



BUGS            The destruction of unsuspecting users' files

                should soon be fixed.  A limitation that may

                eventually go away is the restriction to assem-

                bler language format. There should be options for

                FORTRAN, English, etc., lexical analysis.



                File names longer than eight characters cause

                misalignment in the output if tabs are set at ev-

                ery eighth column.



OWNER           lem