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 / ZSUS009.LBR / Z3HELP28.LBR / RENAME.HZP / RENAME.HLP
Text File  |  2000-06-30  |  9KB  |  174 lines
  1. ;
  2.                                  RENAME.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. RENAME.CIM     4k (31)   CA81  3.5        Gene Pizzetta 7/90       Z3COM10
  6. RENAME.COM     4k (31)   A256  3.5        Gene Pizzetta 7/90       Z3COM10
  7.  
  8.   1- Syntax/Options  2- Usage  3- Notes  4- Examples of Use                   
  9.  
  10.  
  11.    RENAME is  a transient program for renaming files.  More powerful than REN,
  12. RENAME allows ambiguous  file names and inspection.  Vs 3.0 (5/84) by R. Conn.
  13. :1
  14.  Syntax     
  15.  
  16.   Old style (newname=oldname):
  17.      RENAME {dir:}afn.aft=afn.aft{,{dir:}afn.aft=afn.aft{,...}} {{/}options}
  18.  
  19.   New style (oldname newname):
  20.      RENAME {dir:}afn.aft afn.aft{,{dir:}afn.aft afn.aft{,...}} {{/}options}
  21.  
  22.   Interactive control mode (oldname):
  23.      RENAME {dir:}afn.aft{,{dir:}afn.aft{,...}} {{/}options}
  24.  
  25.    The first form shows elements of the CP/M style form (dir:afn1=afn2).   The 
  26. second  form  shows elements of the MS-DOS style form  (dir:afn2  afn1).   The 
  27. third form adds an element of the single-filespec form (dir:afn), which is the 
  28. same  as  the completely pointless 'dir:afn=afn' except that it  automatically 
  29. invokes a Control Mode which allows the user to rename files individually.
  30.  
  31.    All three forms may be mixed within a command line.  If no DIR or DU speci-
  32. fication is given,  the current  drive/user is  assumed.   Multiple  file list
  33. elements must be separated by commas without intervening spaces.
  34.  Options 
  35.  
  36.         A leading slash is optional.
  37.  
  38.    E    Erase existing  files  without prompting.   If RENAME  finds  that the
  39.         renamed file will have the same name as an existing file,  it normally 
  40.         asks if the existing file should  be  erased.   Using this option will 
  41.         cause such files to be erased without prompting.
  42.  
  43.    I    Inspect mode.   Each matching filename  is  displayed  and the user is 
  44.         prompted.   A  response of  "Y"  will cause the  file  to  be renamed.  
  45.         Entering "Q" or  ^C  will exit the program.   Any  other response will 
  46.         skip the file and then prompt for the next matching filename.
  47.  
  48.    S    Toggle inclusion  of system  files.   Whether RENAME recognizes system 
  49.         files by default is  determined by  a configuration  byte in the first 
  50.         record of the COM file  preceded by the  ASCII string "SYSFILES>".  If 
  51.         the byte is zero, system files are ignored;  if it is non-zero, system 
  52.         files are  erased.   The default condition is reversed by this option.  
  53.         As distributed, the default is to exclude system files.
  54. :2
  55.  Usage - 1/2 
  56.  
  57.    If only one,  possibly ambiguous,  filename is  given,  RENAME  will  enter
  58. Control mode.   Each matching filename will be  displayed individually and the
  59. user will be asked to specify the  new  name  for that file.   Pressing only a
  60. carriage return will skip renaming of the currently displayed file.   Entering
  61. ^C will abort the program.
  62.  
  63.    If the ZCPR3 quiet flag is  set,  all  screen output is suppressed,  except 
  64. error messages and required prompts.   If the E option is not given and RENAME 
  65. finds an existing file with the same name,  for instance, the user is prompted 
  66. for permission to erase the  file even if the  quiet flag is on.   Inspect and 
  67. Control modes prompt normally at all times.
  68.  
  69.    ZEX input is turned off while RENAME is running.
  70.  
  71.    On exit the program error flag  is set to 10  (source file not found) if no 
  72. files are renamed, unless the program is aborted at  a prompt  with "Q" or ^C.  
  73. In addition,  the number of files renamed is entered into ZCPR3 register 0 (up 
  74. to a maximum of 255).   If an invalid option is given,  the program error flag 
  75. is set to 19 and the error handler is invoked.
  76.  Usage - 2/2 
  77.  
  78.    READ/ONLY CAUTION:   RENAME renames  read/only files  without warning.   In 
  79. addition, if an existing file is  read/only,  it will  also  be erased without 
  80. warning if the E option is  used  or if the "Erase?" prompt is answered with a 
  81. "Y".
  82.  
  83.    This "feature" should probably be removed.   It  would  be better if RENAME 
  84. acted like ERASE, prompting "Read/Only, Rename?" or "Read/Only, Erase?" before 
  85. doing  anything.   An  "R"  option could  be  added  to  allow  bypassing  the 
  86. questions.  
  87. :3
  88.  RENAME Notes - 1/4 
  89.  
  90.    a. Besides  allowing ambiguous  file names  and  supporting  inspection and
  91.       control modes,  RENAME accepts a list of files, renames Read/Only files, 
  92.       and sets the  attributes (R/O, SYS) of the new file names to be the same 
  93.       as those on the old file names.
  94.  
  95.    b. Vs 3.5 updates (07/01/90, Gene Pizzetta):
  96.       - Changed filename display to "oldfile to newfile" instead of the 
  97.         strange "newfile from oldfile".  
  98.       - Added configuration byte after ASCII string 'SYSFILES>' to chose 
  99.         whether to include system files by default (non-zero) or exclude them
  100.         by default (0).  
  101.       - S option now toggles the default meaning (it's current action is shown 
  102.         by the usage screen.  
  103.       - Now filters high bit of filenames for terminals that display special 
  104.         characters that way.  
  105.       - RENAME no longer signs on with its load address and version number; 
  106.         these are displayed only on the usage screen.  
  107.       - Restored Q (quit) as a valid response to an rename or erase query, but 
  108.         ^C still works.  
  109.  RENAME Notes - 2/4 
  110.  
  111.       - Display has been made even more compact than last version.  Many of 
  112.         these changes are to make the RENAME interface very similar to the RCP
  113.         version.  
  114.       - Sets program error flag to 10 if a matching filename is not found.  If 
  115.         an invalid option is given, the program error flag is set to 19 and 
  116.         the error handler is invoked.  
  117.       - ZEX input is suspended during execution of RENAME.
  118.       - The number of files renamed (up to 255) is placed in ZCPR3 register 0.
  119.       - Now obeys ZCPR3 quiet flag, except when in inspect or control mode, or 
  120.         when a prompt is necessary.
  121.       - Removed Wheel byte protection for E and S options.
  122.  
  123.    c. Vs 3.4 updates (03/31/90, Gene Pizzetta):
  124.       - Modified for more compact display, usually a single line for each file
  125.         renamed.  ^C aborts at any prompt.
  126.  
  127.    d. Vs 3.3a updates (12/30/87, Bruce Morgen):
  128.       - Strip high bit from EFCB program name characters.  "E" and "S" options
  129.         require Wheel byte set; help message reflects this.
  130.  RENAME Notes - 3/4 
  131.  
  132.    d. Vs 3.3 updates (12/19/87, Bruce Morgen):
  133.       - Implements the PPIP-style dual syntax.  Control Mode is mandatory  and
  134.         automatic for single-filespec elements.   If a single-filespec element 
  135.         is the last (or only) one in  a RENAME command line,  the second file-
  136.         spec in the last (or only) command  is tested if the MS-DOS  syntax is
  137.         detected.  If that second filespec starts with  a '/' or includes only 
  138.         valid option letters (and no more characters than the number  of valid 
  139.         option letters), it is assumed to be an option specifier rather than a
  140.         rename-to filespec.  
  141.  
  142.    e. Vs 3.2 updates (08/25/87, Jay Sage);
  143.       - Changed to allow  a leading slash  before  an  option  to make program
  144.         consistent with a  number of  other Z  programs (this  was supposed to
  145.         happen, but there was a bug in the code).  Put data into a DSEG.  Made
  146.         header indicate load address.
  147.  RENAME Notes - 4/4 
  148.  
  149.    f. Vs 3.1 updates (04/12/87, Jay Sage):
  150.       - Took idea of Rick Charnes and implemented it  as an option so that one
  151.         does not have to have two versions of the program.  The option is 'E'.
  152.         Also updated code to ZCPR33 type-3 environment to allow linking RENAME
  153.         for execution in high memory if desired.
  154.  
  155.    g. Vs 3.0a updates (04/09/87, Rick Charnes):
  156.       - Modified slightly so  that  if  you try to rename FILE1  to FILE2  and
  157.         FILE2 already exists, the program will NOT ask you if you are sure you
  158.         want to delete FILE2.  
  159. :4
  160.  Examples of Use 
  161.  
  162.    a. RENAME *.txt
  163.  
  164.       - rename all *.TXT files to names input by user
  165.  
  166.    b. RENAME asm:*.mac=*.asm
  167.  
  168.       - rename all *.ASM files to *.MAC
  169.  
  170.    c. RENAME *.obj=*.com SI 
  171.  
  172.       - rename all COM files to OBJ and include SYStem files and Inspect
  173.         and approve each change
  174.