Trailing-Edge
-
PDP-10 Archives
-
BB-J939B-BM
-
documents/blscrf.hlp
There are 2 other files named blscrf.hlp in the archive. Click here to see a list.
BLSCRF.HLP 21 Nov 79
RECENT MODIFICATIONS:
1. 31 character names are now supported.
BLSCRF is a program which cross references BLISS source files. BLSCRF
is invoked by the command:
RUN BLI:BLSCRF
The user may now type a series of cross reference requests. The
command line has the following form:
outfil,gxrfil=srcfil/switch/switch...
where either "outfil" or ",gxrfil" (but not both) may be omitted and
where all switches are optional. The default file extensions are
srcfil: BLI (, B32, B16, B36, B10, B11)
outfil: XRF (GXR if /F is specified with a single output file)
gxrfil: GXR
REQUIRE file: REQ (, B32, B16, B36, B10, B11, R32, R16, R36, BLI)
Upon completion, if no switches have been specified, outfil contains a
numbered listing of srcfil and its REQUIRE files followed by a cross
reference of srcfil suitable for printing on a 132 column line
printer; gxrfil contains a cross reference which is formatted so it
can be sorted with other files of its type to produce a master cross
reference listing of multiple source files.
All REQUIRE files requested in srcfil are included in the cross
reference. All Common BLISS reserved words are excluded from the
cross reference. All line numbers which correspond to lines within
REQUIRE files are flagged by a "+" in the cross reference; all
routine definitions are flagged by "*". All symbols directly
proceeding the assignment operator are flagged with " ".
If the BLISS source module has been edited in the style described in
the VAX/11 Software Engineering Manual
(i.e. inserted lines marked by !Aedit# as in !A05
modified lines marked by !Medit# as in !M11
deleted lines marked by !Dedit# as in !D77)
a list of all lines affected by each edit is output at the end of the
cross reference.
The allowable command switches appear below:
/D The cross reference excludes a listing of the file.
/X BLISS-10 (instead of Common BLISS) reserved words are not cross
referenced.
/Y BLISS-11 (instead of Common BLISS) reserved words are not cross
referenced.
/T Symbols which occur only in REQUIRE files are not cross
referenced.
/E No REQUIRE files are included in the cross reference.
/S All references to line numbers within require files are
suppressed in the cross reference. This switch is useful when a
cross reference is created for use with a compiler listing.
/R Reserved words, keywords, and predefined names are cross
referenced.
/O Only those symbols which occur just once are cross referenced.
/N Only 80 characters per line are output in the cross reference.
/F Specifies that the output file should be a cross reference which
is formatted so that it can be sorted with other files of its
type to produce a master cross reference listing of multiple
source files. This switch is no longer needed as the command
line ,A=B has the same effect as A=B/F.
CONDEN is a program which condenses and cleans up the merged and
sorted cross reference.
The following sequence can be used to create a sorted, merged cross
reference on the DECSYSTEM-20.
@RUN BLI:BLSCRF
*FILEA,FILEA=FILEA
*FILEB,FILEB=FILEB
*FILEC,FILEC=FILEC
*^C
@COPY FILEA.GXR ALLFIL.GXR
@APPEND FILEB.GXR,FILEC.GXR ALLFIL.GXR
@SORT
SORT>SORT/RECORD:150/KEY:1,40,ALPHA,ASCEND/ASCII ALLFIL.GXR FILES.SOR
@RUN BLI:CONDEN
*FILES.XRF=FILES.SOR
*^C
The following sequence can be used to create a sorted, merged cross
reference on the DECsystem-10.
.RU BLI:BLSCRF
*FILEA,FILEA=FILEA
*FILEB,FILEB=FILEB
*FILEC,FILEC=FILEC
*^C
.COPY ALLFIL.GXR=FILEA.GXR,FILEB.GXR,FILEC.GXR
.R SORT
*FILES.SOR=/RECORD:150/ALPHANUMERIC/ASCII/KEY:1:40:A -
ALLFIL.GXR
.RUN BLI:CONDEN
*FILES.XRF=FILES.SOR
*^C
.
FILEA.XRF, FILEB.XRF, and FILEC.XRF now contain the individual cross
reference listings. FILES.XRF contains the sorted, merged cross
reference of all three.
[end of BLSCRF.HLP]