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-5.LBR / V.LBR / VREN.HZP / VREN.HLP
Text File  |  2000-06-30  |  4KB  |  84 lines
  1. ;
  2.                                    VREN.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                4k (26)   710E  1.0        Bruce Morgen 8/88        Z3COM10
  6.  
  7.   1- Syntax/Options  2- Notes  3- Patches                                     
  8.  
  9.  
  10.    VREN (Visual RENamer)  performs interactive  renaming  of files with format
  11. checking.   VREN takes  a single  wildcard filespec from the command  (if none 
  12. given, "*.*" assumed).  It then allows the user to step through the file names
  13. and file attributes and change them using the WordStar(tm) diamond and/or  the
  14. TCAP-defined arrow keys for cursor movement.   VREN tests for illegal renames,
  15. existing files,  wheel privileges  (non-wheels cannot mess with  $SYS  and R/O 
  16. files at all),  duplicate files on the same drive when setting the PUBlic tag, 
  17. etc.  VREN always operates in an overwrite mode - there is no control-V mode 
  18. toggle.  
  19. :1
  20.  
  21.  
  22.    Syntax:  VREN [du: or dir][afn.typ]
  23.  
  24.  
  25.   Options:  <DEL>  <--  delete left                                       
  26.               ^G   <--  delete right                            
  27.                .   <--  delete to filetype                                      
  28.               ^T   <--  toggle attribute                     
  29.              <cr>  <--  do rename                                         
  30.             <ESC>  <--  abort rename
  31.               ^C   <--  exit
  32.                                              ^E
  33.               ^E   <-- previous file          ^ 
  34.               ^X   <-- next file         ^S <- -> ^D
  35.               ^S   <-- previous char          v                  
  36.               ^D   <-- next char             ^X
  37.  
  38. :2
  39.  
  40. VREN Notes:
  41.  
  42.    a. Typing a period (.) moves the cursor to the first character of the  file
  43.       extension,  wiping out  any  remaining filename characters  to  properly
  44.       attributed blanks,  unless the cursor is over the first character of the
  45.       extension, in which case it moves to the last character of the filename.
  46.       Otherwise editing behavior is quite predictable.  
  47.  
  48.    b. There is  a rubout function closely resembling  WS response  and the  WS
  49.       control-G (gobble)  also works,  although  both treat  the filename  and
  50.       extension  as  distinct fields.   A carriage return initiates the actual
  51.       renaming of the file.  
  52.  
  53.  
  54.  
  55. VREN Notes (continued):
  56.  
  57.    c. VREN toggles file  attributes using control-T  as the trigger,  but,  as 
  58.       with a rename,  nothing changes until  a RET.  Any attributed characters 
  59.       are shown in alternate video or lower case if possible.  Unless VREN  is 
  60.       "quieted" there  is  a  "12345678|rsa"  header  for  clarity.   There is 
  61.       protection  against  setting attribute #2,  the home of the Plu*Perfect-
  62.       style "PUBlic" tag,  if more than one file of the name in question exist 
  63.       on the same drive.   To  disable  this  feature for  non-PUBlic  BDOS or 
  64.       vanilla ZRDOS, see "Patching" below.
  65. :3
  66.  
  67.  
  68. Patching:
  69.  
  70.    VREN obeys  the ZCPR3  Quiet Flag  unless  the low (0)  bit  of the byte at 
  71. origin+2 (102h in DDT) is patched to a  non-zero value - in  that case VREN is
  72. always  "quiet."   The  high (7)  bit  of this  byte controls the attribute #2 
  73. protection scheme for Plu*Perfect-compatible  DOSs described above.   Set this 
  74. bit if  you know  what you're doing and want to be able to set attribute #2 at 
  75. will.
  76.  
  77.     Value at origin+2        Results in:
  78.     -----------------        -----------
  79.         00h        "loud" & PUBlic protected
  80.         01h        "quiet" & PUBlic protected
  81.         80h        "loud" & PUBlic unprotected
  82.         81h        "quiet" & PUBlic unprotected
  83.  
  84.