Google
 

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]