home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / fish / disks / d1052.lha / Programs / Move / Move.doc < prev    next >
Encoding:
Text File  |  1995-01-14  |  6.6 KB  |  210 lines
  1.  
  2.  MOVE, written by Kai Iske August 16. 1993
  3.        This is PUBLIC DOMAIN; you may do with it whatever you like
  4.  
  5. If you change/republish/delete/sell the program or do anything similar, please
  6. be so kind to keep my name within the program and all the other files, even
  7. though you`re not obliged to, as for the definition of Public Domain
  8.  
  9. I wrote Move because all of the available moves out there couldn`t suffice my
  10. needs. They lacked this and that, so I wrote my own which also includes
  11. switches like those known from e.g. Rename.
  12.  
  13. MOVE was written using SAS 6.51....
  14.  
  15. !!! Move requires OS 2.x and up to run, Move is PURE !!!
  16.  
  17.  
  18.  
  19. ------------------
  20. What does MOVE ???
  21. ------------------
  22.  
  23.  
  24. Well,  it  moves files from here to there.  You may issue as many source files
  25. as  there fit on one command line, even including patterns.  Issuing directory
  26. names  will  cause  Move  to  create  a  directory of the same name within the
  27. destination  directory  (if  not already existent) and move all the files from
  28. the  source  directory  to  the  new destination.  Furthermore all directories
  29. within  the  source  will be collected recursively.  There are several options
  30. for Move:
  31.  
  32.   Move FROM/M,TO/A,CLONE/S,DATES/S,NOPRO/S,COM/S,QUIET/S,NOREQ/S,FORCE/S
  33.  
  34. Explanation
  35.  
  36.   FROM  : From file(s)/pattern(s)
  37.   TO    : Destination directory
  38.           A destination file will be accepted only if there are no
  39.           multiple files to be moved.
  40.   CLONE : Clones file date, file comment and protection bits
  41.   DATES : Only file dates and file protection will be cloned
  42.   NOPRO : Per default the protection bits will be cloned. You may
  43.           disable this feature using NOPRO
  44.   COM   : Only file comments and file protection will be cloned
  45.   QUIET : Per default Move runs in verbose mode, ie. all file-/dirnames
  46.           will be printed within the Shell. This option will disable
  47.           verbose mode.
  48.   NOREQ : This one is used to disable "Please insert xxx in yyy" Requesters
  49.   FORCE : Move a read-/deleteprotected file to a write/deleteprotected
  50.           file, i.e. no matter what bits are set for a source/destination
  51.           file, it will be moved/overwritten.
  52.   BUFFER: This option may be used during inter-device moves. Normally
  53.           move will allocate as much memory as needed to hold the complete
  54.           file in ram so that only one Read()/Write() pair is needed in
  55.           order to accomplish the move. If there isn`t enough memory
  56.           for the file, Move would try to "fall back" to a suited
  57.           memory size. You may use this option to tell Move the
  58.           maximum buffer size. The size specified will be interpreted
  59.           as KB, so that a value of 1 will result in a 1KB buffer.
  60.  
  61.  
  62.  
  63. Examples
  64.  
  65.   Move *.c *.h SMakeFile PictureDir t:
  66.  
  67.   Will move all files ending with ".c"/".h", a file called SMakeFile, and
  68.   a directory PictureDir to t: (PictureDir will be created then)
  69.  
  70.  
  71.  
  72. -----------------------
  73. How to install MOVE ???
  74. -----------------------
  75.  
  76. Simply copy it to a directory within you search path (eg. C:)
  77.  
  78.  
  79.  
  80.  
  81. -----------
  82. Version 1.0
  83. -----------
  84.   - initial release
  85.  
  86.  
  87. -----------
  88. Version 1.1
  89. -----------
  90.   - Added well known CLONE, DATES, COM, NOPRO,
  91.     QUIET and NOREQ options also used by e.g. Rename
  92.  
  93. -----------
  94. Version 1.2
  95. -----------
  96.   - Added CTRL-C checking
  97.   - Added FORCE Flag in order to move read/deleteprotected or
  98.     to overwrite a delete/writeprotected files
  99.  
  100. -----------
  101. Version 1.3
  102. -----------
  103.   - UnLock Problem solved when doing recursive Dir-Moves
  104.     This bug lead to "Object in use" error messages
  105.  
  106. -----------
  107. Version 1.4
  108. -----------
  109.   - Now uses Rename() when source and dest are on the same
  110.     device. This is faster ;) Why haven`t I thought of that
  111.     earlier ??? ;)
  112.  
  113. -----------
  114. Version 1.5
  115. -----------
  116.   - Freed the FileInfoBlock _BEFORE_ setting the Bits, Comment
  117.     etc. This lead to MungWall hits (of course it did)
  118.     (Reported by Nico Francois)
  119.   - Exidentially called one ExAll() without ED_SIZE
  120.     This lead to some calls to DoTheMove without the Size set ;)
  121.     (Reported by  Karsten Weiss)
  122.  
  123. -----------
  124. Version 1.6
  125. -----------
  126.    - Move got screwed up, when attempting to move a
  127.      zero size file
  128.    - Added Buffer Keyword to specify the maximum buffer
  129.      size for an inter device move. Normally Move would have used
  130.      the max amount of available free memory in order to
  131.      accomplish the move, or the size needed by the file...
  132.      (Suggested by : Christof Damian)
  133.    - One couldn`t rename a file using move, because the
  134.      "destination" file was removed before doing the rename,
  135.      ie. the source file was deleted.
  136.      (Reported by : Chris Conger)
  137.  
  138. -----------
  139. Version 1.7
  140. -----------
  141.    - Error while moving to a "device full" disk
  142.      (Reported by : Chris Conger)
  143.    - FileName length-bug fixed
  144.      (Reported by : Juergen Lang)
  145.    - Recompiled using SAS 6.50
  146.    - Stack usage reduced
  147.  
  148. -----------
  149. Version 1.8
  150. -----------
  151.    - Added PURE information to Doc, since Move really is pure
  152.      (Suggested by : Albert-Jan Brouver)
  153.    - Due to the move-renaming bug one couldn`t rename a dir
  154.      an Assign was put on.
  155.      (Reported by : Albert-Jan Brouver)
  156.    - Fixed move-renaming of directories.
  157.      (Reported by : Albert-Jan Brouver)
  158.    - Move had some severe problems recursively moving
  159.      the contents of a directory
  160.  
  161. -----------
  162. Version 1.9
  163. -----------
  164.    - On recursive moves, Move will indent the output according to
  165.      recursion depth. This is for better readability
  166.    - Move will refuse to move a dir to itself now.
  167.    - One couldn`t move a dir to another dir on the same device
  168.  
  169.  
  170. ------------
  171. Version 1.10
  172. ------------
  173.   - Move didn`t end up some operations with a "moved" string,
  174.     thus leading to corrupted display
  175.     (Reported by : Albert-Jan Brouwer)
  176.   - One still couldn`t rename a directory
  177.     (Reported by : Albert-Jan Brouwer)
  178.  
  179.  
  180. -------------
  181. Version 37.11
  182. -------------
  183.   - Changed version numbering to official scheme
  184.   - One couldn`t move the entire contents of a directory
  185.     to a dir within that directory (eg. Move #? Dummy)
  186.   - One couldn`t move directories, if the destination dirs
  187.     already existed (eg. Move Dummy1 Dummy2 t:; if Dummy1
  188.     and Dummy2 both existed in t:)
  189.   - OldWindow and HitMask vars weren`t preset to 0
  190.     (Reported by : Christian Buchner)
  191.   - When one issued something like this "Move #? dummy/",
  192.     Move stopped when trying to move dummy to itself ;) Fixed
  193.  
  194. Hope you like it, if not, delete it......
  195.  
  196.  
  197.  
  198. So long,
  199.  
  200.      Kai
  201.  
  202.  
  203.  
  204.  
  205.  --- Kai Iske
  206.  Brucknerstrasse 18, 63452 Hanau, Germany, Tel.: +49-(0)6181-850181
  207.  Z-Net    : KAI@SWEET.RHEIN-MAIN.DE   Fido: Kai Iske, 2:244/6302.11
  208.  internet : iske@informatik.uni-frankfurt.de              IRC:kiske
  209.  ---- Life sucks ----
  210.