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

Changing the way procedures are grouped


 The <.EXE name>.GRP file consists of three sections, of which
 only the first is processed by Rescue5, the other two are
 supplied for information.

 The first section is a list of the output source files, each
 with one or more entries after it.  There are three types of
 entry:

   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
   <.EXE name>.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 <.EXE name>.GRP file.

   A procedure name on its own refers to that procedure.

 To change the way procedures are grouped, edit the first
 section:

   To change the name of a source module, over-type the current
   name with the new name (be sure to follow MS-DOS file naming
   conventions).  You cannot change the names of procedures in
   <.EXE name>.GRP.

   To add more procedures into a module, append them to the list
   of procedures already associated with that module, then
   remove them from the list belonging to the module they were
   previously grouped within.

   To create a new module add it to the list and move the
   procedures you want it to contain.


 Module names must be the first item on a line and must be
 followed by a colon, then whitespace (tab, space or new-line),
 then a list of entries separated by whitespace.

 Procedures or groups of procedures from different static
 variable frames (identified by cross reference numbers in
 square brackets) cannot be combined into the same group.

 Procedures or groups of procedures from different static
 procedure frames (identified by cross reference numbers in
 round brackets), and procedures with no static frame can be
 combined, but be careful not to define groups such that
 procedures with the same name end up in the same source file.

 Rescue5 will always emit code that was originally compiled with
 the CA-Clipper /b switch into files with the same name as the
 original, but the extension .SRC.