;
                                   SREN.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
SREN.COM       8k (60)   10D4  1.0        Rob Friefeld 8/90        Z3COM11
SRENINST.COM   5k (40)   D1A6  1.0b       Rob Friefeld 8/90        Z3COM11

  1- Syntax  2- Usage  3- Command Summary  4- Installation  5- Notes          


   SREN is  a full screen file renaming utility.   It uses VLIB4D and its TCAP
for some simple line drawing and cursor on/off, if available.

   SRENINST is the install program  for  setting  up  control key bindings and
default flags to your preference.
:1

    Syntax   SREN [dir:]<mask>


The mask is automatically wild-carded,  and all matching directory entries are
loaded into SREN's internal table.


     Examples:

          SREN           All files in current directory.
          SREN SYS:.c    Load SYS:*.c??
:2
 Usage 

   FILENAMES are edited via a customized line editor.  A <CR> renames the file
to its edited name.   When the cursor moves to a new line, any pending changes
must be dealt with first.   This is automatic unless you configure SREN to ask
about it first.  

   ILLEGAL FILENAME CHARACTERS,  as  defined  by  Digital  Research,  are  not 
accepted.  Many of these characters are used anyway,  e.g. "[" "]" or "/",  so 
the list of excluded characters may be patched to your preference.

   The FILE ATTRIBUTES are edited in a separate field.  <TAB> switches between
the filename editing  field and  the  attribute  field.   To change attributes
individually,  use  cursor  control or  <SP>  then press  S(et),  R(eset),  or
(T)oggle.   For  convenience,  an  ATTRIBUTE SETTING  MACRO  may  be  defined.
Executing the  macro then  sets the  attributes  of  the  current file -- from
either editing field.  The macro has three modes:

     Set   - set specified attributes, reset all others.
     Mask  - set specified attributes, leave others alone.
     Reset - reset specified attributes, leave others alone.
:3
 Command Summary - 1/3 

   SREN displays  a command  summary  on the  right  side of the screen.   ESC
cycles the help screen through several sub-screens.   Here is  a complete list
of the available commands with default settings:

^K    Lead-in Key   Consider also ^Q, ESC
CR    Rename	    Execute changes to file name, advance to next line
^KQ   Exit
^KL   Relog         Restart program on new DIR:MASK
TAB   Switch Field  Switch between File Name editor and Attribute editor
^U    Undo          Reloads original file name or attributes into editor
^Y    Delete File
ESC   Help Screen   Cycles through command summary subscreens (4)
^S    Cursor Left
^D    Cursor Right
^E    Line Up	    Rename file as cursor leaves line
^X    Line Down
^R    Page Up	    Top of this screen, then top of previous screen
^C    Page Down     Bottom of this screen, then bottom of next screen
 Command Summary - 2/3 

^KT   Top Page      First file
^KB   Bottom Page   Last file
^J    Find (Jump)   Search forward with wrap, name wild-carded
^L    Repeat Find
^KM   Define Macro  Attribute setting "macro"
^KA   Execute Macro Set attributes as per macro on current file
BSP   Backspace     Installable destructive or non-destructive

FILENAME EDITING FIELD ONLY

^A	Token Left
^F	Token Right
^G	Delete Char
^T	Delete Token Rt
^V	Toggle Insert
DEL	Delete Left
.	Name/Type	Move cursor to alternate filename.typ field
 Command Summary - 3/3 

ATTRIBUTE EDITING FIELD ONLY

S,R     Set, Reset Attribute
T	Toggle Attribute
SP	Move to next attribute
:4
 Installation 

SRENINST.COM installs the control key bindings and default flags.

Nota Bene --
   File attributes F5-F7 are reserved for use  by the  DOS and should never be
   changed.   SREN ignores  any changes you make to those attributes.  You may 
   set a patch byte to remove the LOCKOUT at your peril.  Have fun!
:5
 SREN Notes - 1/2 

   a. On systems that support the  PUBLIC ATTRIBUTE (F2),  problems arise when
      giving a file the same name as  a  public  file on the same drive.   The
      situation amounts to  having  two  files  of the  same  name in the same
      directory.   SREN reports that the file  exists and  cancels the rename.
      If you are serious,  reset the public attribute before proceding.   SREN
      does not deal with the case of  renaming  an existing file which already
      has the same name as a public file.  My experiments with ZSDOS show that
      the file will be renamed as expected,  but as a side effect,  the public
      file becomes non-public with attribute F7 set.   Lesson:  Never create a
      public file by just setting attributes.  Use FILEATTR!

   b. Vs 1.0b updates (08/28/90, Rob Friefeld):
      - Fixes SRENINST.COM.   The previous version didn't work on systems with
      undefined arrow keys in TCAP.
 SREN Notes - 2/2 

   c. Updates from beta test version 0.1c --
      - FIND command now wraps around to start of list so that the entire list
  	is searched.   It is  now  called  Jump and assigned to ^J.  Much more
        convenient than ESC F for this frequently used command.
      - SREN won't give a file the same name as a public file.
      - Should now work on systems w/ BIOS which trashes alternate registers.
      - If you have already renamed a file and start to change the name AGAIN,
  	UNDO recovers the current name, then the original name.
      - Attribute setting macro is no  longer reset  when logging in a new DU:
      - The "illegal" character list is  rearranged to  put  the ones you most
  	likely want to  delete  at  the  start  of the  list.   Much easier to
  	install.   Just  type "..." until you  get  to  the ones  you  want to
  	retain.
