home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / ZSUS / Z3HELP-3.LBR / M.LBR / MAKERCP.HZP / MAKERCP.HLP
Text File  |  2000-06-30  |  3KB  |  71 lines
  1. ;
  2.                                    MAKE.RCP                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                3k (21)   4AEA  1.8        Ron Bardarson 88         Z3COM6
  6.  
  7.   1- Usage  2- Notes  3- Examples of Use                                      
  8.  
  9.    MAKE.RCP is modeled on the UNIX MAKE.  It runs as  a ZCPR33 RCP,  schedules
  10. source  files  for  assembly/compilation  and   then  monitors  the  assembly/
  11. compilation process,  aborting if errors are detected.   It's superior to  the
  12. FINDERR  method  in  that multiple-pass compilers with overlays  are supported
  13. (PL/I),  or  any compiler  that overwrites  the error location prior  to  warm
  14. booting.   Using MAKE ensures that the latest version of a program is created.
  15. No need to keep track  of what  you modified;  MAKE determines that a modified
  16. file exists and inserts the given command line into the Z3CL.
  17.  
  18.    MAKE.ZRL (provided with vs 1.8) can be loaded into anyone's NZCOM system.
  19. :1
  20.  
  21.    Usage:  MAKE MAKEFILE    //type is assumed as .MKE//
  22.  
  23. MAKEFILE has the following structure:
  24.  
  25.    SOURCE1.MAC    | TRANSLATION STRING
  26.    SOURCE2.PLI    | TRANSLATION STRING
  27.    SOURCE3.MOD    | TRANSLATION STRING
  28.                   "
  29.                   "
  30.                   "
  31.    SOURCEn.FLE    | TRANSLATION STRING
  32. #
  33. LINKER_STRING SOURCE1,SOURCE2,SOURCE3,...SOURCEn
  34.  
  35.    SOURCE.FLE is FILENAME.TYP,  all files are disk&user LOCAL or PUBLIC.   All
  36. TYPs  must be 3 letters or blank-filled.   The OPTIONAL separator/delimitor on
  37. source lines is |.  Any blank or tab  will also work.   TRANSLATION STRING  is
  38. free form to End-of-Line and  is composed  of the commands  you would normally
  39. issue when translating SOURCE.FIL.
  40. :2
  41.  
  42. MAKERCP Notes:
  43.  
  44.    a. Vs 1.8 adds support for  a wide variety of translators.   TOUCH replaces
  45.       the  use of PROTECT in  makefile scripts.   TOUCH  will only  reset  the 
  46.       makefile bit,  thus  preserving system,  read-only,  archive  and  other
  47.       attribute bits.
  48.  
  49.    b. DO NOT CHANGE RCPs WHILE RUNNING MAKE,  or your system will crash.  MAKE
  50.       changes the BIOS CONOUT vector and needs to  complete to change it back.
  51.       If  an error handler is invoked,  then note the error  and continue with
  52.       the remaining commands in the CLB.
  53. :3
  54.  
  55. Examples of Use:
  56.  
  57.    a.   MAKE.RCP   /PUBON
  58.       Z3BASE.LIB   TUCH MAKE.MAC
  59.         MAKE.MAC   M80 =MAKE/M/L
  60.       #
  61.       L80 /P:DFD0,MAKE/N,MAKE/X/U/Y/E;MLOAD MAKE.RCP=MAKE;     <<
  62.         LDR MAKE:MAKE.RCP;/PUBOFF
  63.  
  64.       -- TUCH clears  the  makebit  attribute, which  will cause the  MAKE.MAC
  65.          line  to  be  executed.   TUCH  is  a MAKE.RCP command  to update the 
  66.          makebit without disturbing the other file  attribute  bits.   It  can
  67.          only be used with  a single file, however.   For multiple files,  use
  68.          TOUCH FILE1.EXT,FILE2.EXT,....
  69.  
  70.       -- PUBON/PUBOFF turns public directories on/off.
  71.