;
                                   VREN.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               4k (26)   710E  1.0        Bruce Morgen 8/88        Z3COM10

  1- Syntax/Options  2- Notes  3- Patches                                     


   VREN (Visual RENamer)  performs interactive  renaming  of files with format
checking.   VREN takes  a single  wildcard filespec from the command  (if none 
given, "*.*" assumed).  It then allows the user to step through the file names
and file attributes and change them using the WordStar(tm) diamond and/or  the
TCAP-defined arrow keys for cursor movement.   VREN tests for illegal renames,
existing files,  wheel privileges  (non-wheels cannot mess with  $SYS  and R/O 
files at all),  duplicate files on the same drive when setting the PUBlic tag, 
etc.  VREN always operates in an overwrite mode - there is no control-V mode 
toggle.  
:1


   Syntax:  VREN [du: or dir][afn.typ]


  Options:  <DEL>  <--  delete left                                       
              ^G   <--  delete right                            
               .   <--  delete to filetype                                      
              ^T   <--  toggle attribute                     
             <cr>  <--  do rename                                         
            <ESC>  <--  abort rename
              ^C   <--  exit
                                             ^E
              ^E   <-- previous file          ^ 
              ^X   <-- next file         ^S <- -> ^D
              ^S   <-- previous char          v                  
              ^D   <-- next char             ^X

:2

VREN Notes:

   a. Typing a period (.) moves the cursor to the first character of the  file
      extension,  wiping out  any  remaining filename characters  to  properly
      attributed blanks,  unless the cursor is over the first character of the
      extension, in which case it moves to the last character of the filename.
      Otherwise editing behavior is quite predictable.  

   b. There is  a rubout function closely resembling  WS response  and the  WS
      control-G (gobble)  also works,  although  both treat  the filename  and
      extension  as  distinct fields.   A carriage return initiates the actual
      renaming of the file.  



VREN Notes (continued):

   c. VREN toggles file  attributes using control-T  as the trigger,  but,  as 
      with a rename,  nothing changes until  a RET.  Any attributed characters 
      are shown in alternate video or lower case if possible.  Unless VREN  is 
      "quieted" there  is  a  "12345678|rsa"  header  for  clarity.   There is 
      protection  against  setting attribute #2,  the home of the Plu*Perfect-
      style "PUBlic" tag,  if more than one file of the name in question exist 
      on the same drive.   To  disable  this  feature for  non-PUBlic  BDOS or 
      vanilla ZRDOS, see "Patching" below.
:3


Patching:

   VREN obeys  the ZCPR3  Quiet Flag  unless  the low (0)  bit  of the byte at 
origin+2 (102h in DDT) is patched to a  non-zero value - in  that case VREN is
always  "quiet."   The  high (7)  bit  of this  byte controls the attribute #2 
protection scheme for Plu*Perfect-compatible  DOSs described above.   Set this 
bit if  you know  what you're doing and want to be able to set attribute #2 at 
will.

	Value at origin+2		Results in:
	-----------------		-----------
		00h		"loud" & PUBlic protected
		01h		"quiet" & PUBlic protected
		80h		"loud" & PUBlic unprotected
		81h		"quiet" & PUBlic unprotected

