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 / ENTERPRS / CPM / UTILS / S / ZF10Q.LBR / ZFILER.AZD / ZFILER.ADD
Text File  |  1992-01-14  |  5KB  |  126 lines
  1. ZFILER ADDENDUM   January 13, 1992
  2.  
  3. This file brings Jay Sage's TCJ articles up to date with features added 
  4. in versions 1.0m to 1.0q.  ZFHIST.DOC contains programmer's notes on 
  5. features and bug fixes.
  6.  
  7.  
  8.             ZFILER COMMANDS
  9.             ---------------
  10.  
  11.   Control-I (TAB) is an alias for control-J (jump to file again), for use 
  12. with terminal definitions (TCAPs) which define control-J as an arrow key.
  13.  
  14.  
  15.   It is now possible to answer ZFILER's "Login [DIR][:MASK] " prompt with 
  16. ".<cr>" (same as ":<cr>") to log in all files in the current directory.  
  17. Previously this logged in all files at user zero of the current drive.  The 
  18. Login command now also seems to accept ".afn" instead of ":afn".
  19.  
  20.  
  21.   Group Tag/Untag and Wild Tag can be independently set to operate from the 
  22. file pointer to the end of the ring, rather than on the entire ring.  Group 
  23. Tag/Untag seem to be the most useful if the start at the file pointer.  Use 
  24. the Options command to control this.
  25.  
  26.  
  27.   VIEW and PRINT now have a switchable filter which only passes printable
  28. characters, carriage return, and line feed.
  29.  
  30.   ZFILER now remembers all the file tags when it returns from a macro
  31. or Z command.  (It writes a temporary file, ZFILER.TAG, to a configurable
  32. directory which contains the file list.)
  33.  
  34.  
  35.             ZFILER MACRO SCRIPTS
  36.             --------------------
  37.  
  38.   $* script parameter clears the screen during, and rebuilds it after a 
  39. script prompt.  Usage is $"$*..text.."  Prompt text appears at the top of a 
  40. cleared screen.
  41.  
  42.  
  43.   Prompts in scripts may contain control characters as "^x" where x is any 
  44. character from @ to z.
  45.  
  46.  
  47.   The dollar sign is now an "escape character" for script prompts, and can 
  48. be used to include the $, ^, ", and ' characters in prompts.
  49.  
  50.     Examples:
  51.         Script                Result
  52.         $"Enter name or $^C: "         Enter name or ^C: 
  53.         $"Type $"//$" for help: "    Type "//" for help: 
  54.  
  55.  
  56.   Here is a parameter reminder you can include in your ZFILER.CMD file.
  57.  
  58.     $!     ZEX 'GO'          $P  DU:FN.FT       $D  Current Drive
  59.     $".."  PROMPT            $F  FN.FT          $U  Current User
  60.     $'..'  PROMPT            $N  FN             $C  Current DIR
  61.     $*     CLS on Prompt     $T  FT             $H  Home DU   $R  Home DIR  
  62.  
  63.  
  64.  
  65.             ZFILER GROUP MACROS
  66.             -------------------
  67.  
  68. LIST CAPABILITY FOR GROUP MACROS:
  69.  
  70.   If a ZFILER.CMD script begins with a comma (before or after the leading
  71. "!" shell pause parameter), ZFILER will always expand the macro directly to
  72. ZCPR's multiple command line.  In the case of a group macro, $P, $F, and $T
  73. parameters are expanded to a list of all tagged files, separated by the
  74. character following the leading comma.  
  75.  
  76. For example, the script:
  77.  
  78.         1 , !echo the tagged files are $F
  79.  
  80. displays "THE TAGGED FILES ARE ", followed by a list of the tagged files
  81. separated by " " on the console (assuming ECHO is a valid ZCPR command). 
  82. ZFILER then prompts for a keypress before returning.  Please note that this
  83. macro buffers the entire list of tagged files to CP/M's command line
  84. buffer, which is only 125 bytes in length.  The above command therefore
  85. normally causes a "Command too long" error if more than about 8 files are
  86. tagged, depending on the lengths of the tagged names.
  87.  
  88.   List capability allows programs which accept a file list, such as LPUT or 
  89. V, to run on tagged files.  ZEX is NOT involved.
  90.  
  91.  
  92. GROUP MACRO TAGGED FILE COUNT:
  93.  
  94.   The number of files tagged is put into User Register #5 (configurable) 
  95. before running ZEX.  The macro can then down count and take some additional 
  96. action after it has run on each tagged file.
  97.  
  98.   For example, if you press "G<ESC>1", the script:
  99.  
  100.     1 ! $d$u:;$!crunch $f B1:;reg m5;if reg 5= 0;$"Library DU ":;
  101.             lput $"Library Name: " B1:*.* +1;era B1:*.?Z?;fi;$h:
  102.  
  103. crunches tagged files to a fixed empty directory B1:, makes a library out
  104. of them (leaving room for 1 more file) with input for library name and
  105. location, then erases all the crunchettes.  This macro requires REG to
  106. decrement Register 5.
  107.  
  108.   Note that REG must be a Type3 or Type4 (or RCP) for the ZEX GO "$!" to
  109. run CRUNCH repeatedly.  Also note that registers only hold a 255 count!
  110.  
  111.   For consistency, single macros put a "1" count in the User Register.
  112.  
  113.   User register range 0..9 is not enforced, so you can use registers 10..31
  114. if you wish.  However, 10-15 are reserved, 16-17 are used by other
  115. programs.
  116.  
  117.  
  118.  
  119.             ZFILER INSTALLATION
  120.             -------------------
  121.  
  122.   ZF10Q.CFG configuration file for use with ZCNFG.COM.  Handles all the 
  123. configuration normally needed.  You can use a file patcher to change the 
  124. default names of some of ZFILER's temporary files if you wish.
  125.  
  126.