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 / CPM / ZCPR2 / Z2SYS-3.MOD < prev    next >
Text File  |  2000-06-30  |  13KB  |  330 lines
  1. .fo SOFTWARE UPGRADES to SYSLIB and ZCPR2              Page #
  2.  
  3.               SOFTWARE UPGRADES to SYSLIB and ZCPR2
  4.                           30 April 1983
  5.  
  6.                                by
  7.                           Richard Conn
  8.  
  9.                         New TEMPLATE.MAC
  10.                        New ZCPR2 Utilities
  11.             Modified GENINS to Include New Utilities
  12.           Modified Help Files to Document New Utilities
  13.                       COMPARE.HLP Corrected
  14.  
  15. 1.0  Baselines
  16.  
  17.      Thσá followinτ baselinσ softwarσ i≤ establisheΣ b∙ thi≤á upì
  18. grade:
  19.  
  20.           COMMENT   PAGE   PHELP   SAK   PRINT3
  21. New Vers: GENINS    TEMPLATE
  22.  
  23.  
  24. 2.0  Associated Upgrade Documentation
  25.  
  26.      Z2ALT.HL╨á ha≤ beeε modifieΣ t∩ documen⌠ thσ ne≈á utilities«  ì
  27. An error has been corrected in COMPARE.HLP.
  28.  
  29.  
  30. 3.0  Files Affected by this Upgrade
  31.  
  32.      The following files are provided with this upgrade:
  33.  
  34.           COMMENT.COM    COMMENT.MAC
  35.           GENINS.COM     GENINS.MAC
  36.           PAGE.COM       PAGE.MAC
  37.           PHELP.COM      PHELP.MAC
  38.           PRINT3.COM     PRINT3.MAC
  39.           SAK.COM        SAK.MAC
  40.                          TEMPLATE.MAC
  41.  
  42.           Z2ALT.HLP      COMPARE.HLP
  43.  
  44.  
  45.      These files have the following CRC values:
  46.  
  47.     1 File: COMPARE .HLP -- Size:     7K -- CRC: A4 C0
  48.     2 File: PHELP   .COM -- Size:     8K -- CRC: 0A ED
  49.     3 File: PHELP   .MAC -- Size:    29K -- CRC: D7 B0
  50.     4 File: Z2ALT   .HLP -- Size:    28K -- CRC: AD 4E
  51.  
  52.     1 File: COMMENT .COM -- Size:     1K -- CRC: 88 40
  53.     2 File: COMMENT .MAC -- Size:     6K -- CRC: 51 99
  54.     3 File: GENINS  .COM -- Size:    14K -- CRC: A3 81
  55.     4 File: GENINS  .MAC -- Size:    46K -- CRC: 08 8C
  56.     5 File: PAGE    .COM -- Size:     8K -- CRC: 43 78
  57.     6 File: PAGE    .MAC -- Size:    27K -- CRC: 68 F4
  58.     7 File: PRINT3  .COM -- Size:     8K -- CRC: 19 02
  59.     8 File: PRINT3  .MAC -- Size:    29K -- CRC: 27 12
  60.     9 File: SAK     .COM -- Size:     2K -- CRC: 29 61
  61.    10 File: SAK     .MAC -- Size:     8K -- CRC: 0E D0
  62.    11 File: TEMPLATE.MAC -- Size:    18K -- CRC: 0B 3C
  63.  
  64.  
  65. 4.0  Reasons for Changes to Programs and Files
  66.  
  67.      Ne≈á utilitie≤ havσ beeε addeΣ t∩ thσ ZCPR▓ System«á  GENIN╙ ì
  68. ha≤ beeε modifieΣ t∩ instal∞ PAGE¼ PHELP¼ anΣ PRINT3«  Thσ other≤ ì
  69. can be installed by the previous version of GENINS.
  70.  
  71.      The design of TEMPLATE has been enhanced.
  72.  
  73. 5.0  Impact on ZCPR2
  74.  
  75.      N∩ impac⌠ i≤ expecteΣ oε an∙ oµ thσ ZCPR▓ utilities¼á excep⌠ ì
  76. fo≥ GENINS«  N∩ othe≥ change≤ arσ issued.
  77.  
  78. 6.0  New Documentation
  79.  
  80.      Thσá followinτá i≤ provideΣ a≤ additiona∞á documentatioεá t∩ ì
  81. supplemen⌠á thσ ZCPR▓ Manuals«á  Ne≈ manual≤ wil∞ bσ prepareΣá a⌠ ì
  82. somσ time¼ bu⌠ n∩ change≤ t∩ existinτ manual≤ arσ anticipateΣ fo≥ ì
  83. severa∞á months«á  Thσ followinτ documentatioε i≤ extracteΣá froφ ì
  84. Z2ALT.HLP (new version).
  85.  
  86.  
  87. 6.1  The PAGE Command
  88.  
  89.      Thσá PAG┼ commanΣ i≤ useΣ t∩ lis⌠ file≤ oε thσ console«á  I⌠ ì
  90. offer≤ ß fe≈ advantage≤ ove≥ TYP┼ iε tha⌠ PAG┼ know≤ thσ widtΦ oµ ì
  91. thσ screeε anΣ handle≤ wraparounΣ (whicΦ i≤ ß biτ complain⌠á witΦ ì
  92. TYP┼á wheεá tryinτá t∩á pagσ througΦ "wideóá listing≤á likσá tha⌠ ì
  93. produceΣ b∙ thσ assemblers)«á  PAG┼ als∩ accept≤ ß filσ lis⌠á anΣ ì
  94. supports named directories.
  95.  
  96.      PAGE is invoked by a command line of the following form:
  97.  
  98.           PAGE dir:f1.typ,dir:f2.typ,... o...
  99.  
  100. wherσá "dir:fn.typó i≤ aε ambiguou≤ filσ speπ (wilΣ card≤ ma∙á bσ ì
  101. used⌐á witΦá ß DI╥ prefi° (nameΣ directorie≤ o≥ D╒ forφá allowed⌐ ì
  102. and "o" is one or more of the following options:
  103.  
  104.           0-9  Set Character Print Speed (0=fastest=default)
  105.  
  106.           I    Inspect Files
  107.                     The user is allowed to approve each file to
  108.                     bσ printeΣ beforσ thσ printinτ begins╗ 
  109.                     default is NO Inspection
  110.  
  111.           L    Toggle Line Numbering
  112.                     Each line may be numbered; default is NO Line
  113.                     Numbers
  114.  
  115.           P    Toggle Screen Paging
  116.                     Turε ofµ thσ facilit∙ oµ pausinτ oncσ ß
  117.                     screen is filled; default is Paging Enabled
  118.  
  119.           Snn  Skip to Specified Page
  120.                     Skip to indicated page (size of page on
  121.                     printer) before beginning; default is NO Skip
  122.  
  123.      Thσ SpeeΣ optioε oµ thσ PAG┼ commanΣ shoulΣ bσ discusseΣá iε ì
  124. somewha⌠á morσ detail«á  Whilσ ß filσ i≤ beinτ pageΣ t∩ thσ user¼ ì
  125. thσá use≥ caε strikσ onσ oµ thσ digit≤ t∩ var∙ thσ speeΣá oµá thσ ì
  126. outpu⌠ dynamically«  ░ i≤ thσ fastest¼ ╣ i≤ thσ slowest«  Iε thi≤ ì
  127. way¼á thσá use≥ caε easil∙ scaε ß filσ b∙ runninτ PAG┼ witΦ thσ ╨ ì
  128. optioεá (s∩á i⌠á doe≤ no⌠ sto≡ wheε thσá screeεá i≤á filled⌐á anΣ ì
  129. strikinτá ß digi⌠ froφ timσ t∩ timσ t∩ speeΣ u≡ ove≥ section≤á hσ ì
  130. isn't interested in and slow down for sections he is.
  131.  
  132.      Whilσá thσá outpu⌠á i≤ beinτ directeΣ t∩á thσá screen¼á PAG┼ ì
  133. support≤á thσ followinτ single-characte≥ command≤ t∩á changσá thσ ì
  134. output display in one way or another:
  135.  
  136.           0 to 9 - change speed (0=slowest, 9=fastest)
  137.  
  138.           P or p - toggle pause when screen fills
  139.                     (the user can dynamically turn on and off
  140.                      the ability to delay when a screen fills)è
  141.           ^X     - skip to next file
  142.  
  143.           ^C     - abort to operating system
  144.  
  145.           ^S     - pause output; any key will resume, and all
  146.                     of these commands (except ^S) will work
  147.  
  148.      PAG┼ i≤ constantl∙ acceptinτ use≥ input¼á anΣ thesσ command≤ ì
  149. arσ iε effec⌠ al∞ oµ thσ time«á  Thi≤ include≤ thσ timσ wheε PAG┼ ì
  150. ha≤á pauseΣ afte≥ fillinτ thσ screeε (it≤ default)¼á s∩ thσá use≥ ì
  151. caεá turεá ofµá paginτá o≥ var∙ thσ speeΣ a⌠á thi≤á time¼á iµá s∩ ì
  152. desired«  An∙ othe≥ characte≥ wil∞ bσ ignored.
  153.  
  154. 6.2  The PRINT Command
  155.  
  156.      Thσá PRIN╘á commanΣá i≤ useΣ t∩ prin⌠ ßá filσá oεá thσá LST║ ì
  157. device¼á likσ LIS╘ does¼á bu⌠ offer≤ man∙ morσ options«á  I⌠ wil∞ ì
  158. prin⌠á ß heading¼á pagσ thσ file¼á numbe≥ thσ pages¼á numbe≥á thσ ì
  159. lines¼á placσ ß date/timσ stam≡ oε thσ output¼á pu⌠ thσ filσ namσ ì
  160. oε thσ output¼ anΣ others.
  161.  
  162.      The PRINT command is of the following form:
  163.  
  164.           PRINT dir:f1.typ,dir:f2.typ,... o...
  165.  
  166. wherσá "dir:fn.typóá i≤ aε ambigou≤ filσ namσ witΦ ßá DI╥á prefi° ì
  167. (supportinτá thσ D╒ forφ o≥ ß nameΣ directory⌐ anΣ "oó i≤ onσá o≥ ì
  168. morσ oµ thσ following:
  169.  
  170.           E - Exact Print (Expand Tabs, Form Feed, No Line or
  171.                Page Numbers, No Heading)
  172.  
  173.           F - Toggle default of file name display on page header
  174.                (defaul⌠ i≤ ON¼ so ╞ turn≤ ofµ name display)
  175.  
  176.           H<delim>text<delim> - Define Heading text to appear
  177.                at the top of each page
  178.  
  179.           I - Inspect Files (allow user to select files before
  180.                printing begins)
  181.  
  182.           L - Enable numbering of each line
  183.  
  184.           M - Disable Multiple Run Flag
  185.                (if multiple run is ON, then no "Set Top of Form"
  186.                 message appears for each file and PRINT moves
  187.                 from one file to another unattended); default is
  188.                with Multiple Run ON
  189.  
  190.           N - Disable numbering of each page
  191.  
  192.           Sn - Start printing on page n
  193.  
  194. è
  195.           T - Toggle date/time stamp in the header of each page
  196.                (a TIME subroutine must be assembled into PRINT
  197.                 to enable the date/time stamp feature)
  198.  
  199.      Thσá specifiπá feature≤á oµá thσá printe≥á arσá se⌠á b∙á thσ ì
  200. installe≥á witΦá GENINS«á  SucΦ feature≤ includσá thσá numbe≥á oµ ì
  201. physica∞ line≤ oε ß page¼á thσ numbe≥ oµ line≤ oµ tex⌠ oε ß page¼ ì
  202. anΣ thσ widtΦ oµ ß linσ iε characters.
  203.  
  204.      Thσ date/timσ stam≡ featurσ i≤ ver∙á machine-dependent¼á anΣ ì
  205. PRIN╘ ha≤ t∩ bσ reassembleΣ t∩ suppor⌠ it.
  206.  
  207.      While PRINT is running, the following commands work:
  208.  
  209.           ^C   Abort and return to operating system
  210.  
  211.           ^X   Skip to top of next page and skip to next file
  212.  
  213. 6.3  The PHELP Command
  214.  
  215.      Thσá PHEL╨ commanΣ i≤ ß specia∞ versioε oµ PRIN╘ designeΣ t∩ ì
  216. prin⌠ Hel≡ (HLP⌐ files«á  PHEL╨ know≤ abou⌠ thσ structurσ oµ Hel≡ ì
  217. Files¼á anΣ i⌠ use≤ thi≤ informatioε t∩ prin⌠ theφ iε ß preferreΣ ì
  218. format«  Iµ i⌠ i≤ dealinτ witΦ aε indexeΣ Hel≡ File¼ PHEL╨ print≤ ì
  219. thσá inde° oε thσ firs⌠ pagσ anΣ thσ bod∙ startinτ oε thσá seconΣ ì
  220. page«á  PHEL╨á alway≤á skip≤á t∩ thσ to≡ oµ ß ne≈á pagσá wheεá i⌠ ì
  221. encounter≤ aε informatioε section«á  I⌠ output≤ ß ne≈ linσ wheε ß ì
  222. forφá feeΣ characte≥ (useΣ b∙ HEL╨ t∩ breaδ screeε displays)¼á a≤ ì
  223. opposed to causing a page eject.ì
  224.  
  225.      The PHELP command is of the following form:
  226.  
  227.           PHELP dir:f1.typ,dir:f2.typ,... o...
  228.  
  229. wherσá "dir:fn.typóá i≤ aε ambigou≤ filσ namσ witΦ ßá DI╥á prefi° ì
  230. (supportinτá thσ D╒ forφ o≥ ß nameΣ directory⌐ anΣ "oó i≤ onσá o≥ ì
  231. morσ oµ thσ following:
  232.  
  233.           H<delim>text<delim> - Define Heading text to appear
  234.                at the top of each page
  235.  
  236.           I - Inspect Files (allow user to select files before
  237.                printing begins)
  238.  
  239.           L - Enable numbering of each line
  240.  
  241.           Sn - Start printing on page n
  242.  
  243.           T - Toggle date/time stamp in the header of each page
  244.                (a TIME subroutine must be assembled into PRINT
  245.                 to enable the date/time stamp feature)
  246.  
  247.      A≤á witΦ PRINT¼á ^├ abort≤ thσ printou⌠ anΣ ^╪ skip≤ t∩á thσ ì
  248. next file after issuing a form feed.è
  249. 6.4  The SAK Command
  250.  
  251.      SA╦á (Strikσá An∙ Key⌐ wa≤ designeΣ t∩ providσá somσá simplσ ì
  252. utilit∙ functions¼á onσ oµ whicΦ i≤ associateΣ witΦ thσá Multiplσ ì
  253. CommanΣ Linσ featurσ oµ ZCPR2«  I⌠ wa≤ designeΣ fo≥ thσ followinτ ì
  254. purposes:
  255.  
  256.           1.  to allow the user to program a wait in a multiple
  257.                command line until he instructs the system to
  258.                continue
  259.  
  260.           2.  to allow the user to abort a multiple command line
  261.  
  262.           3.  to allow the user to program an interruptable delay
  263.                in the execution of a multiple command line
  264.  
  265.           4.  to provide a simple alarm for the user
  266.  
  267.      The SAK command line is:
  268.  
  269.           SAK o...
  270.  
  271. where "o" is zero or more of the following options:
  272.  
  273.           A    -- DO NOT Allow the User to Abort the MCL
  274.           B    -- Ring Bell
  275.           Pnn  -- Pause nn seconds and continue if no response
  276.  
  277.      WitΦ N╧ options¼á SA╦ wait≤ fo≥ use≥ input¼á anΣ iµ thσ use≥ ì
  278. strike≤á ßá ^C¼á theεá thσ multiplσ commanΣ linσ i≤á aborteΣá anΣ ì
  279. control is returned to the user.
  280.  
  281.      SA╦ i≤ particularl∙ usefu∞ iµ thσ use≥ wishe≤ t∩ interjec⌠ ß ì
  282. dela∙á iεá ßá multiplσ commanΣ linσá generateΣá b∙á ßá Menu«á  Aε ì
  283. applicatioεá whicΦ ╔ founΣ usefu∞ wa≤ t∩ displa∙ thσ timσ t∩á thσ ì
  284. user¼á cal∞ hi≤ attentioε t∩ i⌠ (viß ECHO)¼ givσ hiφ ß dela∙ (viß ì
  285. SAK), and then invoke dBASE II with an initializing command file.
  286.  
  287.  
  288. 6.5  The COMMENT Command
  289.  
  290.      COMMEN╘ i≤ ß simplσ routinσ whicΦ allow≤ thσ use≥ t∩ typσ a≤ ì
  291. man∙á line≤á a≤ hσ wishe≤ withou⌠ theφ beinτ processeΣ b∙á ZCPR2«  ì
  292. It has no arguments.
  293.  
  294.      COMMENT has two main applications in the ZCPR2 environment:
  295.  
  296.           1.  when the console displays are being recorded,
  297.                COMMENT allows the user to easily type notes
  298.                to the future reader without having to begin
  299.                lines with a semicolon (;); all of these lines
  300.                are clearly shown to be comments since they begin
  301.                with the prompt "COMMENT>"
  302. è
  303.           2«  wheε consolσ I/╧ i≤ redirecteΣ t∩ tw∩ differen⌠
  304.                users, such as CRT and MODEM I/O in parallel,
  305.                then COMMENT may be used to provide a simple
  306.                mechanism for them to communicate; both users
  307.                can type to each other without having any effect
  308.                on the system (such as command processing)
  309.  
  310.      COMMEN╘á i≤ aborteΣ b∙ strikinτ ß ^├ a≤ thσ firs⌠á characte≥ ì
  311. oµ ß line«  Backspacσ anΣ Deletσ botΦ servσ t∩ ech∩ a≤ Backspace¼ ì
  312. space, backspace, and ^X and ^U both erase the current line.
  313.  
  314.      Iµá COMMEN╘ i≤ t∩ bσ useΣ t∩ cha⌠ betweeε tw∩ users¼á i⌠á i≤ ì
  315. recommendeΣ tha⌠ aε over/ou⌠ protoco∞ bσ employeΣ (a≤ recommendeΣ ì
  316. witΦ thσ UNI╪ WRIT┼ program)«á  Thσ firs⌠ use≥ types¼á and¼á wheε ì
  317. finished¼á terminate≤á witΦ thσ lette≥ "oó fo≥ over«á  Thσ seconΣ ì
  318. use≥á type≤ anΣ signal≤ completioε thσ samσ way«á  Completioεá oµ ì
  319. thσá conversatioεá ma∙ bσ signalleΣ b∙ "o+oó fo≥á ove≥á anΣá out«  ì
  320. Example:
  321.  
  322. COMMENT> Hi, Charlie, how's it going? o
  323. COMMENT> Hi, Rick, fine ... and you? o
  324. COMMENT> Fine, Charlie
  325. COMMENT> Here is how I use XDIR -- let me do the typing
  326. COMMENT> from now on ... just watch, and I'll reenter COMMENT
  327. COMMENT> when done ... here goes o+o
  328.  
  329.  
  330.