home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / RND11.ZIP / RND.DOC < prev   
Text File  |  1993-11-28  |  6KB  |  124 lines
  1.  
  2.                                    RND.DOC
  3.                                    -------
  4.                            Instructions for RND.COM
  5.                            Version 1.1 (28 Nov 1993)
  6.  
  7.                              (c)1991-93 E. Meyer
  8.  
  9.  
  10.      RND allows you to rename or move directories with a single command, which 
  11. is much easier and faster than using DOS commands to create a new directory, 
  12. copy the contents (including subdirectories), then delete the original one.
  13.  
  14.      Several other free or shareware utilities for this purpose exist, but 
  15. some are large and inefficient (RND.COM is just 2k!), some use awkward input 
  16. conventions, some can't move to another position in a tree, most can't move to 
  17. another drive, and none seem to handle changes to the current directory on a 
  18. drive correctly.
  19.  
  20.      A good directory and tree display utility, such as my own DTA (dir/tree/ 
  21. attrib), will be a useful aid in your use of RND.  Experiment with both a 
  22. little to be sure you understand how RND works.
  23.  
  24.  
  25. SYNTAX:        A>rnd DIRNAME NEWNAME
  26.  
  27.               Wildcards (?,*) or "parent" notation (..) may not be 
  28.          used.  Neither argument can be the root directory, "\".
  29.               DIRNAME must be an existing subdirectory, and NEWNAME 
  30.          a valid subdirectory name that does not yet exist.  Any 
  31.          incomplete directory path will be filled in according to 
  32.          standard DOS rules.  "." may be used for DIRNAME, to 
  33.          indicate the current directory.  A drive alone may be used 
  34.          for NEWNAME, to mean the same directory on the other drive.
  35.               If you type "RND" alone (or with the option "/?") you 
  36.          will get a brief help message.
  37.  
  38.      If a new path is not specified, the directory is simply RENAMED.  If the 
  39. new path is different, then the tree is reorganized so that the directory 
  40. (with all subdirectories) is MOVED to a different parent directory.  (You can 
  41. rename and move at the same time; see examples below.)  In either case the 
  42. process is very fast, involving only rearrangement of directory information.  
  43. Only if you are moving to another drive will the files in the directories 
  44. actually have to be copied and deleted, which takes longer.
  45.  
  46.  
  47.                               EXAMPLES: RENAMING
  48.  
  49. 1.  C:\WORK>rnd d:\wp writing     Renames dir D:\WP       --> D:\WRITING
  50. 2.  C:\WORK>rnd sue susan         Renames dir C:\WORK\SUE --> C:\WORK\SUSAN
  51. 3.  C:\WORK>rnd . current         Renames dir C:\WORK     --> C:\CURRENT
  52.  
  53.                                EXAMPLES: MOVING
  54.  
  55. 4.  C:\WORK>rnd bill d:           Moves dir C:\WORK\BILL  --> D:\WORK\BILL
  56. 5.  C:\WORK>rnd sue d:\temp\sue   Moves dir C:\WORK\SUE   --> D:\TEMP\SUE
  57. 6.  C:\WORK>rnd \wp \urgent\wp    Moves dir C:\WP         --> C:\URGENT\WP
  58.  
  59.                         EXAMPLES: MOVING AND RENAMING
  60.  
  61. 7.  C:\WORK>rnd \wp \wp\letters   Moves dir C:\WP         --> C:\WP\LETTERS
  62. 8.  C:\WORK>rnd sue \susan        Moves dir C:\WORK\SUE   --> C:\SUSAN
  63.  
  64.      The first four examples are straightforward; the rest may call for some 
  65. explanation.  Example 5 moves the SUE subdirectory out of the C:\WORK 
  66. directory into the D:\TEMP directory (which will be created if necessary).
  67.        C:\              D:\                 C:\            D:\
  68.           \work                    -->         \work          \temp   
  69.                \SUE                                                \SUE
  70.                    \...                                                \...
  71.      Example 6 moves WP down the directory tree, from a subdirectory of C:\ to 
  72. one of C:\URGENT (which will be created if necessary).
  73.                  C:\                        C:\
  74.                     \work          -->         \work
  75.                     \WP                        \urgent
  76.                        \...                           \WP
  77.                                                          \...
  78.      Example 7 is potentially confusing.  It too moves WP one level down the 
  79. tree; this time it also renames it to LETTERS, while making it a subdirectory 
  80. of a new directory (otherwise empty) called \WP!
  81.                  C:\                        C:\
  82.                     \work          -->         \work
  83.                     \WP                        \wp
  84.                        \...                       \LETTERS
  85.                                                           \...
  86.      Example 8 renames SUE to SUSAN and moves it up the directory tree on 
  87. drive C, from a subdirectory of C:\WORK to one of the root C:\.
  88.                  C:\                        C:\    
  89.                     \work          -->         \work
  90.                          \SUE                  \SUSAN
  91.                              \...                    \...
  92.  
  93.  
  94.                                     ERRORS
  95.  
  96.      RND works on all MSDOS systems (2.x and above); it uses no low level disk 
  97. access, just standard DOS calls.
  98.      When moving directories, there must be enough free space on the disk to 
  99. create the new directory tree (and, if moving to another drive, to copy all 
  100. the files contained).  Paths cannot exceed 66 characters in length.
  101.      In a batch file, the DOS ERRORLEVEL can be tested: RND returns 1 for a 
  102. bad argument, 2 for an invalid or existing directory name, 4 if it runs out of 
  103. memory, and 8 for an error encountered while attempting to move a directory 
  104. (including full disk).
  105.  
  106.  
  107.                                VERSION HISTORY
  108.  
  109.      RND 1.0 (Oct91) - First release.
  110.          1.1 (Nov93) - Handles current directory properly under DOS 5 & 6.
  111.  
  112.  
  113.  
  114.      RND and its documentation are (c)1991-93 Eric Meyer, all rights reserved.  
  115. They may be freely distributed, but not modified or sold for profit without my 
  116. written consent.  (Exception: Libraries may charge up to $6 for a disk.)  The 
  117. user takes full responsibility for any damages resulting from the use of this 
  118. program.  For a disk with the latest versions of all my programs send $10 to:
  119.  
  120.                  Eric Meyer
  121.               3541 Smuggler Way              CompuServe [74415,1305]
  122.            Boulder, CO  80303  USA
  123.  
  124.