home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / mar94 / os20 / cli / move.lha / Move / Move.doc < prev    next >
Text File  |  1994-01-31  |  5KB  |  165 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.
  7.  
  8. I wrote Move because all of the available moves out there couldn`t suffice my
  9. needs. They lacked this and that, so I wrote my own which also includes
  10. switches like those known from e.g. Rename.
  11.  
  12. MOVE was written using SAS 6.3....
  13.  
  14. !!! Move requires OS 2.x and up to run, Move is PURE !!!
  15.  
  16.  
  17.  
  18. ------------------
  19. What does MOVE ???
  20. ------------------
  21.  
  22.  
  23. Well,  it  moves files from here to there.  You may issue as many source files
  24. as  there fit on one command line, even including patterns.  Issuing directory
  25. names  will  cause  Move  to  create  a  directory of the same name within the
  26. destination  directory  (if  not already existent) and move all the files from
  27. the  source  directory  to  the  new destination.  Furthermore all directories
  28. within  the  source  will be collected recursively.  There are several options
  29. for Move:
  30.  
  31.   Move FROM/M,TO/A,CLONE/S,DATES/S,NOPRO/S,COM/S,QUIET/S,NOREQ/S,FORCE/S
  32.  
  33. Explanation
  34.  
  35.   FROM  : From file(s)/pattern(s)
  36.   TO    : Destination directory
  37.           A destination file will be accepted only if there are no
  38.           multiple files to be moved.
  39.   CLONE : Clones file date, file comment and protection bits
  40.   DATES : Only file dates and file protection will be cloned
  41.   NOPRO : Per default the protection bits will be cloned. You may
  42.           disable this feature using NOPRO
  43.   COM   : Only file comments and file protection will be cloned
  44.   QUIET : Per default Move runs in verbose mode, ie. all file-/dirnames
  45.           will be printed within the Shell. This option will disable
  46.           verbose mode.
  47.   NOREQ : This one is used to disable "Please insert xxx in yyy" Requesters
  48.   FORCE : Move a read-/deleteprotected file to a write/deleteprotected
  49.           file, i.e. no matter what bits are set for a source/destination
  50.           file, it will be moved/overwritten.
  51.   BUFFER: This option may be used during inter-device moves. Normally
  52.           move will allocate as much memory as needed to hold the complete
  53.           file in ram so that only one Read()/Write() pair is needed in
  54.           order to accomplish the move. If there isn`t enough memory
  55.           for the file, Move would try to "fall back" to a suited
  56.           memory size. You may use this option to tell Move the
  57.           maximum buffer size. The size specified will be interpreted
  58.           as KB, so that a value of 1 will result in a 1KB buffer.
  59.  
  60.  
  61.  
  62. Examples
  63.  
  64.   Move *.c *.h SMakeFile PictureDir t:
  65.  
  66.   Will move all files ending with ".c"/".h", a file called SMakeFile, and
  67.   a directory PictureDir to t: (PictureDir will be created then)
  68.  
  69.  
  70.  
  71. -----------------------
  72. How to install MOVE ???
  73. -----------------------
  74.  
  75. Simply copy it to a directory within you search path (eg. C:)
  76.  
  77.  
  78.  
  79.  
  80. -----------
  81. Version 1.0
  82. -----------
  83.   - initial release
  84.  
  85.  
  86. -----------
  87. Version 1.1
  88. -----------
  89.   - Added well known CLONE, DATES, COM, NOPRO,
  90.     QUIET and NOREQ options also used by e.g. Rename
  91.  
  92. -----------
  93. Version 1.2
  94. -----------
  95.   - Added CTRL-C checking
  96.   - Added FORCE Flag in order to move read/deleteprotected or
  97.     to overwrite a delete/writeprotected files
  98.  
  99. -----------
  100. Version 1.3
  101. -----------
  102.   - UnLock Problem solved when doing recursive Dir-Moves
  103.     This bug lead to "Object in use" error messages
  104.  
  105. -----------
  106. Version 1.4
  107. -----------
  108.   - Now uses Rename() when source and dest are on the same
  109.     device. This is faster ;) Why haven`t I thought of that
  110.     earlier ??? ;)
  111.  
  112. -----------
  113. Version 1.5
  114. -----------
  115.   - Freed the FileInfoBlock _BEFORE_ setting the Bits, Comment
  116.     etc. This lead to MungWall hits (of course it did)
  117.     (Reported by Nico Francois)
  118.   - Exidentially called one ExAll() without ED_SIZE
  119.     This lead to some calls to DoTheMove without the Size set ;)
  120.     (Reported by  Karsten Weiss)
  121.  
  122. -----------
  123. Version 1.6
  124. -----------
  125.    - Move got screwed up, when attempting to move a
  126.      zero size file
  127.    - Added Buffer Keyword to specify the maximum buffer
  128.      size for an inter device move. Normally Move would have used
  129.      the max amount of available free memory in order to
  130.      accomplish the move, or the size needed by the file...
  131.      (Suggested by : Christof Damian)
  132.    - One couldn`t rename a file using move, because the
  133.      "destination" file was removed before doing the rename,
  134.      ie. the source file was deleted.
  135.      (Reported by : Chris Conger)
  136.  
  137. -----------
  138. Version 1.7
  139. -----------
  140.    - Error while moving to a "device full" disk
  141.      (Reported by : Chris Conger)
  142.    - FileName length-bug fixed
  143.      (Reported by : Juergen Lang)
  144.    - Recompiled using SAS 6.50
  145.    - Stack usage reduced
  146.  
  147.  
  148.  
  149. Hope you like it, if not, delete it......
  150.  
  151.  
  152.  
  153. So long,
  154.  
  155.      Kai
  156.  
  157.  
  158.  
  159.  
  160.  --- Kai Iske
  161.  Brucknerstrasse 18, 63452 Hanau, Germany, Tel.: +49-(0)6181-850181
  162.  Z-Net    : KAI@SWEET.ZER            usenet : kai@iske.adsp.sub.org
  163.  internet : iske@informatik.uni-frankfurt.de              IRC:kiske
  164.  ---- Life sucks ----
  165.