Changes in specifications per control-line

1. +DECK, dname, T=type, IF=...

   with the T= parameter one can signal the data-type of the contents of the deck. The standard data types are now:

         T=FORT   for Fortran         (also T=CO*mpile)
         T=CC     for C language      (also T=X*cc)
         T=AS     for assembler       (also T=A*s*)
         T=DATA   for data            (also T=D*ata)
         T=INCL   for C include files
         T=SHELL  for shell-scripts
         T=CRAD   for cradles

   The right-hand set is for back-compatibility, the * separates the required from the optional extra characters. A*s* means A or anything starting with AS.

   It is now possible to have user-defined data types; this is described in sect. 7.

   The special T parameter J*oin is still used to suppress page-ejects in listings at the start of the deck which has it.

2. +PATCH, pname, T=type, IF=...

   as for +DECK, with the extra T parameter R*epeat as in version 4.

3. +ASM, ...

   The handling of ASM output had to be thoroughly re-organized to be able to handle the user-defined data types mentioned above. As a result the line +ASM is now quite different, see sect. 7. Nypatchy has been programmed to recognize the simpler old forms of +ASM, here comes a summary, for details see sect. 7.

   Lines like

                 +ASM, 31, 34.
                 +ASM, 31, 34, T=ATT   .fcdiv.f

   are handled correctly.

   Lines like

                 +ASM, 31.
                 +ASM, 24, 34.

   are accepted, but are redundant: giving a file-name on the program call statement for a particular ASM stream establishes this stream; stream 34 (CC diverted) is linked to stream 24 (CC normal) by default.

   A line like

                 +ASM, 23, R=!           ./*DECK ID>, !.inc */
             or  +ASM, 23, LUN=21, R=!   ./*DECK ID>, !.inc */

   will cause an error, normally one would replace it by

                 +ASM, DATA, T=RH  .!/*DECK ID>, !.inc */

   but if one wants to use the same cradle with versions 4 and 5 for a time one could give:

                 +ASM, 23, R=!, IF=-PY_VS5   ./*DECK ID>, !.inc */
                 +ASM, 23, T=RH, IF=PY_VS5  .!/*DECK ID>, !.inc */

   A line like

                 +ASM, 23, LUN=24, R=!   ./*DECK ID>, !.inc */

   would have to be replaced by 2 lines

                 +ASM, DATA, T=RH  .!/*DECK ID>, !.inc */
                 +ASM, CC, DATA, T=BIND.

   the second line binding stream 23 (DATA) to stream 24 (CC).

4. +OPTION, opt1, opt2, ..., IF=...

   At least 3 characters have to be given for the "opt" values, and further characters, if any, have to be correct.

         OFF        as before, set options OFF, not ON;
         ALL        as before;
         BAC*kcom   back-compatible mode, this relaxes the new syntax
                    checks somewhat, "on" by default for the time being;
         COM*pact   as before, "on" by default;
         EJE*ct     new: honor c/ls "+SEQ, QEJECT, N=n" in listings;
         FUL*L      as before, "on" by default;
         MAP*asm    as before;
         VER*bose   new: print full summary at the end,
                    "on" by default only if the printed output goes
                    to a file, not to the screen.

5. +PAM, (LABEL=)n, N=x,y, T=opt, RETURN=pname, IF=... .file-name

   All of these parameters are optional, their significance is much the same as with version 4:

         LABEL=n    with n a small integer, this is needed only to identify
                    a PAM to be read partially and to be resumed later.
   
         N=ndo      as before: process the first ndo PAM files, default 999
         N=nsk,ndo  skip the first nsk PAM files, and then process
                    the next ndo files.
   
         T=opt:
         T=ATTACH   as before: read the file whose name is given in the
                    comment field; the LUN=lun parameter is no longer needed;
         T=HOLD     as before: no rewind/close at the end of processing;
         T=RESUME   as before: no rewind before processing;
         T=UPDATE   as before: PAM file to be updated;
         T=CARDS    is accepted and ignored for back-compatibility.
   
         R=pname    as before: stop reading after patch pname.

   The old parameter P=pname,type is no longer needed nor accepted: the title is now considered to be a patch whose name is the Pam-file identifier prefixed with the "commercial at", thus the patch name of the title of the ZEBRA Pam file would be @ZEBRA.

   The typical old +PAM control-line like

         +PAM, 11, T=CAR,ATTACH   .zebra

   is still fine, the "11" is now taken as a label which in this case is not useful but does not hurt, the CAR option is ignored because Pam files are now anyway in "card" format, it has the same effect as the new standard:

         +PAM, T=ATTACH .zebra

6. +PARAMETER, option, N=value, IF=...

         LIN*es     simplified, give only one value to "N=",
                    the number of lines per page, default 110
         COL*umns   new: the page-width, default 120, minimum 90
         CLA*sh     as before

7. +TITLE

   One can now give the Pam file title directly on the +TITLE line:

      old:   +TITLE.
             PATCHY   5.00 /55  1994/02/08 11.20
   
      new:   +TITLE:  PATCHY   5.00 /55  1994/02/08 11.20

   Note the use of the colon ":".