This is XREF, an SPL cross reference program.                                                                                       
                                                                                                                                    
It reads an SPL program from the input file TEXT, and sends the                                                                     
cross reference listing to the file LIST                                                                                            
                                                                                                                                    
It has various PARM options that can be selected by setting PARM                                                                    
options in the RUN ...;PARM=... command                                                                                             
                                                                                                                                    
Options:                                                                                                                            
   Bit#  Action caused by setting the bit                                                                                           
   ----  --------------------------------                                                                                           
   09 = Print only UNUSED items!                                                                                                    
   10 = Suppress report of Lowlevel statements                                                                                      
        (ASSEMBLE, SET, PUSH, ABSOLUTE)                                                                                             
   11 = Report usage of TOS                                                                                                         
   12 = Print report of unused items that came                                                                                      
        from $INCLUDE files                                                                                                         
        (normally suppressed)                                                                                                       
   13 = Suppress report of UNUSED items                                                                                             
   14 = Dont try to interpret $IF cards                                                                                             
   15 = Do read INCLUDE files                                                                                                       
                                                                                                                                    
Commands may be embedded within the source file, if they                                                                            
start with "!%XREF" in columns 1..6 (uppercase).                                                                                    
                                                                                                                                    
Commands:                                                                                                                           
                                                                                                                                    
   [no]DEBUG1                                                                                                                       
   [no]DEBUG2                                                                                                                       
   [no]ECHO                                                                                                                         
   [no]EXCLude    ... mark identifiers on following lines                                                                           
                      as "used" so an "UNUSED" won't report them.                                                                   
                      NOEXCLUDE turns off this marking.                                                                             
   [no]IF                                                                                                                           
   [no]INCLUDES                                                                                                                     
   [no]SPLASH                                                                                                                       
   [no]TRACING                                                                                                                      
   SAY rest-of-line ... prints the rest of the line to stdlist.                                                                     
                                                                                                                                    
For further information, contact:                                                                                                   
   Stan Sieler                                                                                                                      
   sieler@allegrosupport.com                                                                                            
                                                                                                                                    
Sample UDCs:                                                                                                                        
                                                                                                                                    
   xref TEXT, LIST=$STDLIST, PARM=0                                                                                                 
   FILE TEXT=!TEXT                                                                                                                  
   FILE LIST=!LIST                                                                                                                  
   RUN XREF.PUB.ALLEGRO;PARM=!PARM                                                                                                  
   RESET TEXT                                                                                                                       
   RESET LIST                                                                                                                       
   *************************                                                                                                        
   unused TEXT, LIST=$STDLIST, PARM=64                                                                                              
   XREF !TEXT, !LIST, !PARM                                                                                                         
   *************************                                                                                                        
                                                                                                                                    
Sample use of UDCs:                                                                                                                 
                                                                                                                                    
   (assuming source is in QEDIT file FOO)                                                                                           
                                                                                                                                    
      :xref FOO      ... lists (to terminal) cross reference of                                                                     
                         items delcared in FOO                                                                                      
                                                                                                                                    
      :unused FOO    ... lists items declared but not used in FOO                                                                   
                                                                                                                                    
Sample output (partial):                                                                                                            
                                                                                                                                    
                                                                                                                                    
   :xref foo, , 1                                                                                                                   
                                                                                                                                    
      The ",,1" means: I want to look at $include files.                                                                            
                                                                                                                                    
   Reading source file...<><>.........                                                                                              
                                                                                                                                    
      XREF prints one dot for each "procedure" it sees.                                                                             
      The "<" indicates that it has opened ("entered") a $include                                                                   
      file.                                                                                                                         
      The ">" indicates that it has closed ("exited") a $include                                                                    
      file.                                                                                                                         
                                                                                                                                    
   AUTOREF  (LOGICAL)                                                                                                               
         *225       2793      *2794      *2799       3091                                                                           
                                                                                                                                    
      The above indicates that AUTOREF is first seen at sequence                                                                    
      # 225, and is assigned into at sequence numbers 225, 2794,                                                                    
      and 2799.                                                                                                                     
                                                                                                                                    
   POUT  (BYTE POINTER)                                                                                                             
         *167>       557#       573#       573#                                                                                     
                                                                                                                                    
      The above indicatges that POUT is first seen at sequence #                                                                    
      167 of an include file (the ">"), and is seen as the result                                                                   
      of expanding a define (the "#") at main source file                                                                           
      sequence numbers 557, and (twice on ) 573.                                                                                    
                                                                                                                                    
Authorship:                                                                                                                         
                                                                                                                                    
      1974        Mike Green                                                                                                        
      1975..1979  Ken Mintz                                                                                                         
      1979        Roy Smith                                                                                                         
      1979        Dan Mathias                                                                                                       
      1979..1980  Michael Paivinen                                                                                                  
      1981..2011  Stan Sieler