home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Power Programming
/
powerprogramming1994.iso
/
progtool
/
c
/
xrf.arc
/
XRF.DOC
< prev
next >
Wrap
Text File
|
1985-02-05
|
4KB
|
123 lines
TITLE
xrf Cross-Reference Lister for C Programs
AUTHOR
Written By:
Bob Denny
Creative System Design Co.
3452 E. Foothill Blvd. << Suite 601 >>
Pasadena, Ca. 91107
(213) 355-6836
Modified for MSDOS By:
Mike Cole
Digital Equipment Co.
PC Customer Information & Support Centre,
Jays Close,
Basingstoke,
Hampshire RG22 4DE,
ENGLAND. (44) 256-59200
SYNOPSIS
xrf [-options] [-o outfile] [file ...] [file...]
DESCRIPTION
xrf prepares a cross-reference listing for C source programs. The
following options are defined:
-n Narrow output (80 columns). The default is 132 columns.
-i Symbol size is 31, else truncated to 8 characters (default).
-s Spool output to the default line printer.
-p Print C source (with linenumbers)
-c Concatanate input files(s). The default is seperate reference
listings for each file.
-o file Write output to the named file. The default is the first input
file encountered, with a filetype (extension) of ".REF".
[file] Name(s) of C programs. xrf accepts wild-card file input.
The '.c' suffix is provided automatically.
NOTES
1. Input files may have wild-card names.
2. File Specifications are stated WITHOUT AN EXTENSION.
An input extension ".C" is added automatically.
An output extension ".REF" is added automatically.
3. If the -o option is not used, an output filename is constructed
as "<first_input_file>.xrf".
4. Logical names can be used for output, E.G. "-o con" will output direct
to the console (screen).
5. For the spool option to work, the MSDOS "PRINT" command must have
been used previously. EG PRINT<c/r> will just establish the
resident print spooler.
HISTORY
Experimental Version X1.0 5-May-80
Split off initialization X1.1 7-May-80
Prototype. Y1.2 9-May-80
Release. V1.3 9-May-80
Chg. for DECUS OTS. & Cmplr. V1.4 1-Jul-80
Add support for RT-11 V1.5 3-Jul-80
Conditionalized spool call V1.6 MM 9-Jul-80
Added narrow, outfile, etc. V1.7 MM 10-Jul-80
Added multiple infiles V1.8 MM 22-Jul-80
Fspool now in the library V1.9 MM 2-Aug-80
MSDOS version V1.10MC 13-Jan-85
DIAGNOSTICS
xrf ran out of main memory space. Trying to get too much.
Internal error, get help.
Not enough memory space.
Specified file not found. Cannot open "file"
Cannot open output file "file"
Parameter error. Usage ...
BUGS
None known (I hope).
CREATING FROM SOURCES
To Create DECUSC Cross Referencer using Computer Innovations C Compiler
version 2.20h a batch file CXRF.BAT has been provided. If you alter sources
afterwards, you can use LXRF.BAT to relink
To use, ARCH -m xrf | ARCH -rx xrf
LCMP \cic\h\ \CIC\LIB\
CXRF has two parameters: 1 = path for CIC "stdio.h" file.
2 = path for CIC "c86s2s.lib" file (small model only).
Messages you should see:-
Create DECUSC Cross Referencer using Computer Innovations C Compiler
Compiling XRF0 ....
Compiling XRF1 ....
Compiling XRF2 ....
Compiling XRF3 ....
Compiling XRFD ....
Compiling XRFR ....
Compiling SPOOL ...
linking XRF .......
Things that can go wrong:-
1 stdio.h path wrong <%1stdio.h>
Compile of XRF failed. Parameter 1 wrong
2 library path wrong <%2c86s2s.lib>
Compile of XRF failed. Parameter 2 wrong
3 Compile of XRF failed. Error in last action.
Check source files and
compiler version.