Click above to get retro games delivered to your door ever month!

The APTFILER.GRP file


 The APTFILER.GRP file consists of three sections;
 the first is used by Rescue5 during the second pass,  the
 second and third are provided for information.

 The first section in the APTFILER.GRP file looks like this:


  MAIN.UDF:       [0]                                     
  ERRORSYS.UDF:   DEFERROR(140)  ERRORMESSA(145)          
  PUSHSCR.UDF:    [1]                                     
  ISMOUSE.UDF:    [2]                                     
  TBKEYHAN.UDF:   [3]                                     
  APTBOX.UDF:     [4]                                     
  GETSYS.UDF:     [6]                                     
  LIB.UDF:        NORMPATH     APTSTABILI   TBQUIT        
                  FNAME        APTBACKPLA   HILITE        
                  APTINPUTBO   PBUTT                      
  APTALERT.UDF:   APTALERT                                


 Each entry refers to a single source module, named on the left.

 Each source module has its contents listed alongside it.  There
 are three types of item:

   A number within square brackets is a cross reference to a
   list of procedures that share a common static variable.  For
   convenience these lists are reproduced in Section 2 of the
   APTFILER.GRP file.

   A procedure name with a number in round brackets is a cross
   reference to a list of procedures that share a common static
   procedure.  For convenience these lists are reproduced in
   Section 3 of the APTFILER.GRP file.

   A procedure name on its own refers to that procedure.


 To get a clearer idea of how procedures have been grouped on
 the first pass, look at the second section in APTFILER.GRP:


  [0]: APTFILER        TRIMPATH(12)    APTDIRECTO           
       SELECTFILE(33)  GETWCARD(44)                         
  [1]: PUSHSCR         PUSHHOT         POPSCR               
       SPUT            SGET            SIS                  
       SDEL            TBGETUDM        TBPUTUDM             
       TBDELUDM        PUSHWORKAR      POPWORKARE           
       POPHOT          ISHOT           HOTSNEST             
       APTMLINES       APTSWITCH                            
  [2]: ISMOUSE         APTMOUSE        MDBLCLK              
       VSCROLLBAR      HSCROLLBAR      MBVSCROLL            
       MBHSCROLL       MTBBROW         GETMOVBLOC(104)      
       MFKEYS          MGVSCROLL       MGBROW               
       MBUTT           APTINKEY                             
  [3]: TBKEYHANDL                                           
  [4]: APTBOX          APTBUTTONS      APTDISPMSG           
  [6]: READMODAL       CLEARGETSY(215) SETTLE(216)          
       POSTACTIVE(217) GETREADER       RESTOREGET(220)      
       GETPREVALI      GETAPPLYKE      GETPOSTVAL           
       GETDOSETKE      SHOWSCOREB(231) DATEMSG(242)         
       READEXIT        GETACTIVE       GETREADVAR(252)      
       __SETFORMA      __KILLREAD      UPDATED              
       READINSERT      RANGECHECK      READKILL             
       READUPDATE      READFORMAT                           


 These first two sections in combination give you the name of
 each source file and its contents.  For example, in the first
 section the file called ISMOUSE.UDF refers to cross reference
 index [2].  In the second section the contents of reference [2]
 are listed as the procedures:

  [2]: ISMOUSE         APTMOUSE        MDBLCLK              
       VSCROLLBAR      HSCROLLBAR      MBVSCROLL            
       MBHSCROLL       MTBBROW         GETMOVBLOC(104)      
       MFKEYS          MGVSCROLL       MGBROW               
       MBUTT           APTINKEY                             

 The third section lists static procedure interdependencies.
 This information is relevant if you want to restructure the
 source files on the second pass. On the left are static
 procedures, called from the procedures listed on the right.
 You can track interdependent procedures by tracing them through
 the list:

  TRIMPATH(12):    APTFILER        SELECTFILE(33)           
  SELECTFILE(33):  APTFILER                                 
  GETWCARD(44):    APTFILER                                 
  GETMOVBLOC(104): MTBBROW                                  
  DEFERROR(140):   ERRORSYS                                 
  ERRORMESSA(145): DEFERROR(140)                            
  CLEARGETSY(215): READMODAL                                
  SETTLE(216):     READMODAL                                
  POSTACTIVE(217): READMODAL                                
  RESTOREGET(220): READMODAL                                
  SHOWSCOREB(231): POSTACTIVE(217) GETPREVALI GETAPPLYKE    
                   GETPOSTVAL      GETDOSETKE               
  DATEMSG(242):    GETPOSTVAL                               
  GETREADVAR(252): POSTACTIVE(217)                          

 For example, aptFiler calls getWcard, selectFile and trimPath.
 selectFile in turn calls trimPath.  This means that we could
 move aptDirectory out of MAIN.UDF, but aptFiler, selectFile,
 getWcard and trimPath must be kept together.