;
                                   VREN.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
VREN.3OM       4k (27)   3A4A  1.1        Bruce Morgen 6/91        Z3COM25
VREN.4OM       4k (32)   25E8  1.1        Bruce Morgen 6/91        Z3COM25
VREN.COM       4k (27)   9335  1.1        Bruce Morgen 6/91        Z3COM25

  1- Syntax/Options  2- Usage  3- Patching  4 - Notes                         

   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.  Vs 1.0 (8/8/88) by Bruce Morgen.
: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
 Usage 

   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.  

   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 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".
: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
:4
 VREN Notes 

   a. Version 1.1 updates (6/5/91, Bruce Morgen):
      - Modified/pruned VREN and MYSORT.
      - Created WILDEN module to  replace  WILDEX with the  addition of Type 4
        compatibility.  If the program type is 4, the filename buffer is built
        below the program, if not it is  above  the program as in version 1.0.
        With the "short" equate set true, the Type 4 VREN 1.1 is just under 32
        records (4K) in size.
