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 / ZCPR33 / A-R / PLF10.LBR / PLF.DZC / PLF.DOC
Text File  |  2000-06-30  |  9KB  |  182 lines
  1.  
  2.  
  3. ** You've tried GLF" . . . 
  4.  
  5.  
  6. **** AND YOU'VE PROBABLY USED "TLF" . . . 
  7.  
  8.  
  9. *******  N O W   --   G E T   R E A D Y   F O R . . .  **********
  10.  
  11.  
  12. ******************************************************************
  13. *                                                                *
  14. *                      PLF - Process Library Files               *
  15. *                                                                *
  16. *                                  by                            *
  17. *                                                                *
  18. *                         Rick Charnes (10/16/87)                *
  19. *                                                                *
  20. ******************************************************************
  21.  
  22.  
  23.          +++++++++++++++++++++++++++++++++++++++++++++
  24.  
  25.              GUINNESS BOOK OF WORLD RECORDS WINNER:
  26.  
  27.                    "World's longest alias"
  28.  
  29.            $$$$   1st prize 1st prize 1st prize   $$$
  30.  
  31.          +++++++++++++++++++++++++++++++++++++++++++++
  32.  
  33.  
  34.  
  35. SYNTAX:  PLF [DIR:]LIBNAME<CR>
  36.  
  37. PLF is a multi-purpose ZCPR3.3 library alias to be inserted in one's 
  38. ALIAS.CMD, used to type, extract, and/or print up to three individual 
  39. compressed or uncompressed members from inside a library in a single 
  40. pass from its internal command line.  The compressed files may be 
  41. crunched or squeezed.  They will be uncompressed during extraction.  PLF 
  42. combines the functions of GLF and TLF and adds much more.
  43.  
  44. After loading, PLF will present you with a directory of the specified 
  45. library and prompt you for the name(s) of the file(s) to view, extract, 
  46. or print.  One, two or three filenames may be specified.  To view, 
  47. enter either '/V' ('View') or '/T' ('Type'), then the filename(s) 
  48. separated by spaces, i.e. as individual parameters.  To extract, first 
  49. enter '/E', then up to three filename parameters.  A DIR: or DU: 
  50. specification may be given on any or all filenames to which to extract 
  51. the file(s), and wildcards may be used.  Since LT, the program that PLF 
  52. uses for viewing library files, is patched to ignore all common binary 
  53. filetypes, entering '/V *.*' or other file mask involving wildcards 
  54. works quite nicely.  PLF/LT will type on the console each text file in 
  55. the library and ignore all non-ASCII files.
  56.  
  57. To print, use '/P' instead of 'E'.  PLF will extract your file(s), print 
  58. them and then erase them so as not to clutter up your disk.  If you are 
  59. using the standard, shorter floppy disk version of PLF (PLF.CMD), you 
  60. will be then be put into an "inspect" mode for printing.  If the file 
  61. presented to you is indeed one you wish to be printed, you may type "Y" 
  62. or <CR> and the file will be printed.  The longer, hard and RAM disk 
  63. version (PLF-RAMD.CMD) works in a more automatic fashion and usually is 
  64. able to select your files for you.  
  65.  
  66. PLF assumes with the printing option that you have no need for the files 
  67. existing on disk outside the library and therefore erases them after 
  68. printing.  Wildcards may be used with the /P option only if all files 
  69. are uncompressed.
  70.  
  71. Finally, one often wants to extract and rename a file in the same 
  72. operation, so PLF makes provision for this with its '/R' switch.  The 
  73. first parameter after the '/R' should be the desired file to extract, 
  74. with the proper DIR:/DU: spec if desired, followed by the filename to 
  75. which you wish it renamed.  Be sure to specify the correct DIR: at the 
  76. FIRST filename.  Unlike view, extract or print, the rename option will 
  77. permit only one filename.
  78.  
  79. After any of these (optionally multi-file) operations you will again be 
  80. presented with a directory and an opportunity to repeat the operations.  
  81.  
  82. CTL-C to abort when done.
  83.  
  84. A help screen may be brought up if PLF is invoked with no parameter or 
  85. the traditional ZCPR3 '//' help syntax.
  86.  
  87. -------------------
  88.  
  89. REQUIREMENTS:
  90. ------------
  91.  
  92. This alias requires ZCPR3.3, and will work without modification only on 
  93. systems allowing the <SPACE> character to go directly to extended 
  94. command processing.  Users with systems configured to permit only the 
  95. ALTSPACE character ('/') should simply change the space characters.
  96. PLF assumes you are running a version of ARUNZ that runs at 8000 hex.  
  97. (see the GO command in P4).
  98.  
  99. You must also be using the Z33 flow control package and Z33IF.COM for 
  100. PLF to work.  Your ECHO, transient or resident, should be able to 
  101. display lower case letters with '%>'.
  102.  
  103. Files you must have along your path:  
  104. -----------------------------------
  105.  
  106. Not supplied:  PRINT.COM
  107.                RS.COM (RESOLVE.COM renamed)
  108.                LT.COM (standard CP/M Library Typer)
  109.                LLF.COM                                 
  110.                SAK.COM
  111.                LEX.COM (Bob Peddicord's new Library EXtracter)
  112.     
  113. Supplied:      S.COM (quiet-patched version of SHVAR.COM)
  114.                REG.COM (quiet-patched ZCPR3 utility for use only if you 
  115.                   do not have REG turned on in your RCP)
  116.                RENA.COM (Terry Hazen's great RENAMZ renamer renamed)
  117.                T.COM (My own patched version of TYPEL36)
  118.                M.LBR (put this in your A0: directory, contains 
  119.                   help file PLF, typed by T.COM)
  120.  
  121. My preferred message of creating and accessing a help message screen or 
  122. status display is by making a text file and storing it in a file M.LBR 
  123. that I always keep in A0:.  Then in my alias I read/display it with my 
  124. version of TYPEL.COM renamed to T.COM.  This is short, very fast 
  125. (loads much faster than making a COM file out of it with one of the text- 
  126. to-COM-file makers and storing it in one's COMMAND.LBR) and packs a real 
  127. wallop.  One can fit a huge number of help and status messages in one's 
  128. M.LBR.  This is what I have done with my help file PLF which is stored 
  129. inside M.LBR here.  I urge folks to adopt this method if they find it 
  130. valuable.  My own M.LBR has perhaps 25 tiny text files that add greatly 
  131. to the professional appearance of my aliases.  Using an ECHO command 
  132. line directly inside one's alias is sometimes fine but quickly overflows 
  133. the command line buffer for anything but the very shortest messages.
  134.  
  135. The file 'S.COM' provided in this package is SHVAR.COM renamed to save 
  136. space in this alias, and should be placed along your path.  I am at all 
  137. times in my alias-writing process acutely cognizant of the 200- 
  138. character command line buffer limit, and I always do everything I 
  139. possibly can to conserve space.  Renaming files is one of the easiest ways 
  140. to do this.  I long ago renamed the ELSE command in my FCP to L; all my 
  141. alias use this L command.  In a long alias using much flow control this 
  142. can save a tremendous amount of space.  I have supplied in PLF10.LBR my 
  143. own version of the alias in which I use 'L' for 'ELSE'.  If you take a 
  144. look at P7 you see I can fit an extra possible filetype in there that 
  145. overflows the command line buffer if the full name ELSE is used.  
  146.  
  147. I have done the same with my RCP ECHO command which I have renamed to E; 
  148. I do a lot of ECHOing and status reporting and this saves me precious 
  149. buffer space in long aliases.
  150.  
  151. I make use in PLF of the ZCPR3 register 0.  This alias works best if you 
  152. have REG implemented in your RCP, and also that it be patched to not 
  153. echo any console display.  Otherwise you're bothered by the display of 
  154. numbers floating on screen as the register value is sent to the console.  
  155. This can get distracting and takes away from the professional "feel."  
  156. The easiest way to do this is to go into RCPREG.LIB and put a single RET 
  157. instruction just before the routine "REGTEST01:".  I have provided a 
  158. version of RCPREG.LIB modified in this way.  If you would like to have 
  159. your registers set quietly simply re-assemble your RCP using this file.
  160. Then if you ever want to have the register numbers echoed to screen as 
  161. they are changed, simply rename your transient REG.COM and use it for 
  162. those purposes.
  163.  
  164. If on the other hand, God forbid you don't have REG turned on in your 
  165. RCP, and prefer not to for some reason, I have also provided a patched 
  166. version of the transient REG.COM (do not distribute this) that will do 
  167. its thing without displaying anything to the screen.  Setting the quiet 
  168. flag in one's command line and running the unpatched REG.COM is not 
  169. sufficient; it will not print its sign-on message but will still display 
  170. the register value.  We want NO screen output at all; this takes care of 
  171. it.
  172.  
  173. Have fun with PLF.  Please phone or write if you like it or have any 
  174. comments.
  175.                    
  176. Rick Charnes
  177. (415) 826-9448 or, only if the first is busy, 821-4345.
  178. 1165 Shotwell St.
  179. San Francisco, CA 94110
  180.           
  181. Rick Charnes
  182. (415) 826-9448 or, only if