home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / utility / jw.zip / MOVE.DOC < prev    next >
Text File  |  1991-11-21  |  5KB  |  109 lines
  1. MOVE "moves" files from one drive and/or directory to another. It uses the 
  2. DOS rename function if the move is within the same drive (even if different 
  3. directories). This is much faster than physically moving the data. If the 
  4. move is between two different drives, the data is physically moved and then 
  5. deleted from its former location. A file will not be written over without 
  6. your permission. READ ONLY status will be ignored if you give permission to 
  7. write over an existing destination file (and READ ONLY status will not be 
  8. reset on the new copy). If the file you are moving (the source) is READ 
  9. ONLY, it will not be deleted and you will be advised that the result is 2 
  10. copies, the original at the source and the new destination copy.
  11.  
  12.   FORMAT: move [path]source [path]destination
  13.  
  14. The usual DOS wild cards are acceptable, so MOVE \TXT\*.DOC \PVT will 
  15. move all .DOC files from the \TXT directory to the \PVT directory. Files 
  16. can be renamed while being moved by specifying the new name in the 
  17. destination. For instance, MOVE \TXT\*.DOC \PVT\*.XXX will move all of 
  18. the .DOC files from the \TXT subdirectory to the \PVT subdirectory, while 
  19. changing all of their extensions from .DOC to .XXX.
  20.  
  21. If MOVE can not find a directory with the destination name you specify, and 
  22. the remainder of your destination path is valid, MOVE will assume that a 
  23. new filename is being requested. To refer to the example above, if you 
  24. specify MOVE \TXT\*.DOC \PVT and you do not have a \PVT directory, MOVE 
  25. will assume that you want to to try to move all of the \TXT\*.DOC files 
  26. into the root directory and rename them all PVT. After it has moved the 
  27. first one, it will find a duplicate name at the destination and will give 
  28. you the opportunity to quit.
  29.  
  30. If you omit the destination entirely, MOVE assumes that the destination 
  31. is the current directory. For instance, MOVE C:\UTIL\*.DOC will be 
  32. regarded the same as MOVE C:\UTIL\*.DOC *.*.
  33.  
  34. If MOVE encounters a file name at the destination that is a duplicate
  35. of a file name it is trying to move from the source, it offers the 
  36. following options:
  37.   Overwrite the destination file with the source file;
  38.   Skip the move, leaving source and destination files as they were;
  39.   Rename the source file and then move it, leaving the destination file 
  40.     as it was;
  41.   Quit the program, doing no further moves.
  42.  
  43. The term "Overwrite" is a misnomer. The existing destination file is 
  44. actually renamed with the temporary name $$MOVE$$.$$$. It is deleted only 
  45. when the source file has been successfully copied. The deletion is done 
  46. automatically; or, if the copy process failed, the destination file is 
  47. restored to its original name. You should not find $$MOVE$$.$$$ on your 
  48. disk unless program execution was interrupted.
  49.  
  50. You can not rename a file to the same name as the directory into which you 
  51. are trying to move it. If you have a \TXT directory, you can not put a file 
  52. in it that is also called TXT (since the directory name is actually a kind 
  53. of file name). Move will report a duplicate name if it encounters this 
  54. situation.
  55.  
  56. ==================================================================
  57.  
  58. MOVE can also be used to rename a directory, provided that the old 
  59. and new directory names are on the same drive.
  60.  
  61.   FORMAT: move \dir\name\old \dir\name\new
  62.  
  63. Note that if your source path is more than one level deep, you can only 
  64. change the LAST level you specify in the source path (changing "old" to 
  65. "new" in the example above). For instance, if \DIR\NAME\OLD is a valid 
  66. existing path, the following will work:
  67.  
  68.          COMMAND                           EFFECT ON OLD PATH
  69.          =======                           ==================   
  70.    move \dir \new_dir                       \new_dir\name\old
  71.    move \dir\name \dir\new_name             \dir\new_name\old
  72.    move \dir\name\old \dir\name\new         \dir\name\new
  73.  
  74. The following will NOT work:
  75.  
  76.    move \dir\name \new\name              <- different parent directory
  77.    move \dir\name\old \new\name\old      <- different grandparent
  78.    move \dir\name\old \dir\new_name\old  <- change is not LAST level specified
  79.    move \dir\name\old \dir\new           <- different levels in source & dest.
  80.    move c:\old d:\new                    <- different drives
  81.  
  82. You can rename the directory that you are currently in, however DOS will 
  83. not take notice of the change until you change to another directory. So if 
  84. you have set your DOS prompt to show the directory, it will continue to 
  85. show the old name until you have changed directories.
  86.  
  87. ==================================================================
  88.  
  89. MOVE is freeware from Jim Wygant, copyright 1990. It can be used and 
  90. distributed at no charge, provided no changes are made in the program or 
  91. this documentation. There are no warranties regarding suitability to any 
  92. task. Use at your own risk.
  93.  
  94. If you discover bugs or problems with MOVE, please contact:
  95.   Jim Wygant                 (CompuServe# 73627,2043)
  96.   1130 SW Morrison, #220
  97.   Portland, OR 97205
  98.   (503) 228-3632
  99.  
  100. ==================================================================
  101.  
  102. REVISIONS:
  103.  
  104. 1/29/91 -- fixed an error that was wrongly reported if the destination 
  105. drive was empty.
  106.  
  107. 8/7/91 -- moves to a different drive now retain the original file date 
  108. instead of stamping current date.
  109.