home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / utility / jw.zip / SCOPY.DOC < prev    next >
Text File  |  1992-04-02  |  4KB  |  68 lines
  1. SCOPY (SAFE COPY) copies files with protection against overwriting a duplicate 
  2. at the destination. It uses wild cards (* and ?) in the same manner as the DOS 
  3. COPY command and generally functions the same as COPY, except that it can not 
  4. be used to concatenate files with the "+" sign.
  5.  
  6. FORMAT: scopy [path]source [path]destination
  7.  
  8. For example, SCOPY \TXT\*.DOC \PVT will copy all .DOC files from the \TXT 
  9. directory to the \PVT directory. Files can be renamed while being copied by 
  10. specifying the new name in the destination. For instance, SCOPY \TXT\*.DOC 
  11. \PVT\*.XXX will copy all of the .DOC files from the \TXT subdirectory to the 
  12. \PVT subdirectory, while changing all of their extensions from .DOC to .XXX.
  13.  
  14. As with the DOS COPY command, if SCOPY can not find a directory with the 
  15. destination name you specify, and the remainder of your destination path is 
  16. valid, SOPY will assume that a new filename is being requested. To refer to 
  17. the example above, if you specify SCOPY \TXT\*.DOC \PVT and you do not have a 
  18. \PVT directory, SCOPY will assume that you want to to try to copy all of the 
  19. \TXT\*.DOC files into the root directory and rename them all PVT. After it has 
  20. copied the first one, it will find a duplicate name at the destination and 
  21. will give you the opportunity to quit.
  22.  
  23. If you omit the destination entirely, SCOPY assumes that the destination 
  24. is the current directory. For instance, SCOPY C:\UTIL\*.DOC will be 
  25. regarded the same as SCOPY C:\UTIL\*.DOC *.*.
  26.  
  27. If SCOPY encounters a file name at the destination that is a duplicate
  28. of a file name it is trying to copy from the source, it offers the 
  29. following options:
  30.   Overwrite the destination file with the source file (even if the destination 
  31.     has read only status);
  32.   Skip the copy, leaving source and destination files as they were;
  33.   Rename the new copy, leaving the destination file as it was;
  34.   Quit the program, doing no further copies.
  35.  
  36. The term "Overwrite" is a misnomer. The existing destination file is 
  37. actually renamed with the temporary name $SCOPY$$.$$$. It is deleted only 
  38. when the source file has been successfully copied. The deletion is done 
  39. automatically; or, if the copy process failed, the destination file is 
  40. restored to its original name. You should not find $SCOPY$$.$$$ on your 
  41. disk unless program execution was interrupted. 
  42.  
  43. Because SCOPY does not delete a duplicate destination file until after the 
  44. source file has been successfully copied, you may encounter situations with 
  45. nearly full floppy disks in which the disk is reported as already full. DOS 
  46. COPY would simply write over the duplicate at the destination; SCOPY needs 
  47. enough space initially at the destination for both the source and destination 
  48. files.
  49.  
  50. You can not rename a file to the same name as the directory into which you 
  51. are trying to copy 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). SCOPY will report a duplicate name if it encounters this 
  54. situation.
  55.  
  56. ==================================================================
  57.  
  58. SCOPY is freeware from Jim Wygant, copyright 1992. It can be used and 
  59. distributed at no charge, provided no changes are made in the program or 
  60. this documentation. There are no warranties regarding suitability to any 
  61. task. Use at your own risk.
  62.  
  63. If you discover bugs or problems with SCOPY, please contact:
  64.   Jim Wygant                 (CompuServe# 73627,2043)
  65.   1130 SW Morrison, #220
  66.   Portland, OR 97205
  67.   (503) 228-3632
  68.