home *** CD-ROM | disk | FTP | other *** search
/ Der Mediaplex Sampler - Die 6 von Plex / 6_v_plex.zip / 6_v_plex / DISK6 / OS_13 / DCOPYPM9.ZIP / DCOPY / DCOPY.DOC < prev    next >
Text File  |  1994-02-07  |  11KB  |  260 lines
  1. Overview DCopy V0.9g
  2.  
  3. Author: Axel Peters
  4.         Hof 20
  5.         D-52062 Aachen
  6.         Germany
  7.         Tel. +49-241-28526
  8.  
  9. You can reach me:
  10. Fido-Classic:  2:242/53.25
  11. Internet:      apeters@train.fido.de
  12.  
  13.  
  14. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  15. !                                                                                 !
  16. !          The author makes no warranty for any functions of DCOPY.               !
  17. !                                                                                 !
  18. ! Be carefull deleting Directories, because DCOPY deletes whole directory-trees,  !
  19. !                            with all subdirectories.                             !
  20. !    DCOPY V0.9f is ShareWare. If you find this software usefull, please send     !
  21. !     25.- DM (or $25 US) to the author ( so you will get a next version ).       !
  22. !                                                                                 !
  23. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  24.  
  25.  
  26. News in Version 09b:
  27. - multithreading
  28. - improved PopUp-menu ( DLL-support, open without selection for e.g shell )
  29. - examine programms, befor executing them
  30. - default filemasks
  31. - default directories
  32. - some minor bug fixes
  33. - ask for next diskette, if previous is full, during copy
  34.  
  35. News V09c:
  36. - duplicate function
  37.  
  38. News V09d:
  39. - start seamless Windows-Programms
  40. - DLL-supporting Undelete
  41. - added some parameters for Popup-Menu
  42.  
  43. News V09e:
  44. - DLL-supporting dskcpy2
  45. - enabled multithreading in supporting DLL's ( used DosEnterCritSec before )
  46.  
  47. News V09f:
  48. - Drag & Drop ! ( there may be bugs, please report if you find.)
  49. - DLL-supporting unzip and zip ( there are no zip options supported, but I will write
  50.                                  a configuration for Archivers soon -> arj, lh, ...)
  51. - some fixes
  52.  
  53. News V09g:
  54. - Support shadows while pressing SHIFT-CNTRL during drag.
  55. - Improved Zip-DLL
  56. - Fixed problems with system-modal-dialogs
  57.  
  58.  
  59. How to use Drag and Drop:
  60.  
  61. Up to now there are following actions implemented:
  62. - Drag an object over the source window DCopy will change the current Path and
  63.   select, if possible, the actual file represented by the object.
  64.  
  65. - Drag an object over the destination window will have no effects. Maybe I will do a
  66.   copy or something like that next.
  67.  
  68. - Drag an object from the source or dest window will create a new Object on your WPS,
  69.   or initiate an copy operation.
  70.   NOTE: The only action supported up to now is copy in order to avoid loosing files.
  71.  
  72.  
  73. How to use the Unzip-DLL: ( supports UNZIP 5.0p1 and ZIP 2.0 !)
  74.  
  75. Up to now there are following actions implemented:
  76. ( Sorry but there is no own thread for unzip, because of synchronisation up to now )
  77.  
  78. - If you select a file and start Unzip from your PopUp the actual contents of the
  79.   archive will be displayed.
  80.   You can select files and then click on the Unzip-Button to extract files.
  81.   Files will be extracted to your actual directory (last selected in DCopy )
  82.  
  83. - Draging an new Zip-File over the entry-field will display the contents of it.
  84.   ( entry-field -> the name of your archive )
  85.  
  86. - If you open Unzip without selecting any file, you will be requested for an new
  87.   archive.
  88.   After that you can drag items from the filelists over the listbox so that they are
  89.   added to the archive.
  90.   ( filelist -> the contents of your archive )
  91.  
  92.  
  93.  
  94.  
  95. Install DCOPY on your Desktop with the program-template. All Files
  96. must be in the same Directory. ( DCOPY.EXE DCOPY.TIC DCOPY.CNF DCOPY.DOC ),
  97. or use INSTALL.CMD. The DLL's should be copied in a directory reached by your
  98. LIBPATH-statement.
  99.  
  100. If there are Problems with the dialogboxes, try using parameter "D".
  101. So they will be aligned to the desktop, not to the program-window.
  102.  
  103. The file-box on the left side of the window shows the Source-Directory,
  104. the right box shows the Destination-Directory.
  105. Buttons on the left side only affect Files selected in the left file-box.
  106. Buttons in the middle of the window need a source-file and a destination Directory
  107. to be selected.
  108. Buttons on the right side only affect Files selected in the right file-box.
  109.  
  110. First you must specify a Drive, so klick on the drive you want to use as the
  111. Source and Destination-Drive.
  112.  
  113. After this, the File-box will show the root-directory of the specified drive.
  114. Directories will be bounded by "[]". You can change a directory with a double-
  115. click on the Directory-name. (System-Files get a leading "!")
  116.  
  117. If you select a File or Directory the actual selected size of all files will be shown.
  118.  
  119. You can use a filemask, in order to choose interesting files for your operation.
  120. The filemask can be entered by pressing the MASK-Button.
  121.  
  122. To use more than on filemask seperate them with a colomn (";")
  123. e.g. "*.c;*.h;*.mak;*.dep" to use four filemasks.
  124.  
  125. If you are using a filemask, only matching files will be copied, deleted
  126. or shown in the specified directory.
  127.  
  128. e.g. enter filemask "*.bak".  Then select a directory (or a tree) and press
  129. the delete button. In the following Dialog "Confirm with selection" you should
  130. see your mask "*.bak". So if you press the DELETE-button only files matching
  131. your filemask will be deleted.
  132. This selection also affects the TREE-, COPY-, DELETE-, AIO-, DUP-, MOVE-buttons.
  133.  
  134. The Aio-Button means: Copy Files "All in one" Directory. So all matching files
  135. in the specified directory-tree will be copied to one destination-directory.
  136.  
  137. If you have selected a file, you can use the right mouse button to open an
  138. PopUp menu. This menu will be configured with the DCOPY.CNF-file. You can
  139. start external tools, while using the selected files as parameters.
  140. There is a sample configuration included in the package.
  141.  
  142.    Popup-Menu
  143.    Edit...        , EPM.EXE, %a
  144.    Run...         , %p
  145.    !
  146.    Tool...        , %q, %q, %f
  147.    Shell...       , CMD.EXE
  148.    Attrib...      , ATTRIB.EXE , %q, %f
  149.    !
  150.    >Packer
  151.    <PKUnzip...    , PKUNZIP2.EXE, %f, %w, %o, %n, %d
  152.    <PKZip...      , PKZIP2.EXE, %q, %a, %w, %r
  153.    <PKValidate... , PKUNZIP2.EXE, -t, %-, %f
  154.    <Unzip..       , UNZIP.EXE, %f, %w, %r
  155.    !
  156.    Undelete...    , suppdel.dll, Supp_Undel, %-, %a
  157.    DiskCopy...    , suppcpy.dll, Supp_Copy, %-, %a
  158.    #
  159.    (example popup-menu-configuration)
  160.  
  161. "Popup-Menu":   here starts the menu chapter ( other chapters will follow )
  162. "#"              ends the menu chapter, each line inside this chapter will be used
  163.                  as a menu item
  164. "!"              insert seperator
  165. ">"              Name of a Submenu ( no tools can be used )
  166. "<"              Submenu item      ( same as normal items )
  167. "Edit...":       Text of menuitem.
  168. "EPM.EXE":       Tool to start.
  169. "%a":            All selected files will be parameters for tool.
  170. "%p":            Selected File will be executed
  171. "%f":            Only first file will be parameter for tool.
  172. "%w":            Wait until tool has finished.
  173. "%r":            Refresh file-box selected ( only usefull if wait (%w) is used ).
  174. "%o":            Refresh file-box not selected ( only usefull if wait (%w) is used ).
  175. "%q":            Query paramameter with dialog-box.
  176. "%s":            Source-Directory
  177. "%d":            Destination-Directory
  178. "%n":            Do not terminate tool.
  179. "%c":            start in OS/2 Fullscreen modus
  180. "%b":            start maximized
  181. "-t", "%-":      All tokens without "%" are directly passed to the command line.
  182.                  Because some options are used without a space, this is
  183.                  the default usage.
  184.                  e.g. PKUNZIP2.EXE, -t, %f will be interpreted as
  185.                  "PKUNZIP2 -t<filename>".
  186.                  So you must use the "%-" token to insert a space in the
  187.                  commandline
  188.                  e.g. PKUNZIP2.EXE, -t, %-, %f will be interpreted as
  189.                  "PKUNZIP2 -t <filename>".
  190.  
  191. If you do not specify the directoy in the name of a tool, be shure to use it
  192. in the path enviroment variable. You must use a comma to separate the options !
  193. In the actual version there can be defined up to 50 menuitems. This is nearly
  194. no limitation. But you should use Subdirectories in order to get a small
  195. menuboard and a better overview.
  196.  
  197. DCopy is now able to start all programm types (?!). You can use OS/2, DOS, WINOS2
  198. programms or OS/2, DOS batches ( or develop your own DLL ) in your Popupitem.
  199. These executeable Files must have an apptype. If your prg. does not have one, you must
  200. use "MARKEXE.EXE" to define the right apptype. Programms even can be defined as
  201. WINDOWCOMPAT in order to use a windowed session.
  202.  
  203. You can specify predefined filemasks in the "File-Mask" chapter of the cnf-file.
  204.  
  205.    File-Mask
  206.    *.bak
  207.    *.c;*.h;*.mak;*.dep;*.rc;*.res;*.dlg;
  208.    *.exe;*.com;*.cmd
  209.    #
  210.    (example filemasks in dcopy.cnf)
  211.  
  212. New filemasks will not be saved into your cnf-file. They are only valid for your
  213. current session.
  214.  
  215. With the "S"-buttons you can "snapshot" your current directory path. So you can
  216. select your directory later once again.
  217. In order to use predefined directories there are two chapters added to the cnf-file
  218. "Source-Dir" and "Dest-Dir".
  219.  
  220.    Source-Dir
  221.    C:\TMP
  222.    D:\OS2\SYSTEM
  223.    #
  224.    Dest-Dir
  225.    A:\TEST
  226.    D:\OS2\SYSTEM
  227.    #
  228.    (example direcories in dcopy.cnf)
  229.  
  230. New directories will not be saved into your cnf-file. They are only valid for your
  231. current session.
  232.  
  233. If you kill an action with the "STOP"-button the second thread is killed.
  234. So there might be an incorrect display of your current directory. In order to get
  235. the actual contents use the "Refresh"-buttons.
  236.  
  237. You can create a support DLL for tools on your own. I included the posibility to call
  238. funktions from the Popupmenu in your DLL's. This feature is interresting for users, that
  239. want to build there own DLL. The last lines of the popupmenu configuration shows the
  240. call of an DLL-routine. First you must specify your DLL-name ( Be sure that OS/2 will
  241. find your DLL with the LIBPATH statement ). Then you must specify the function in your
  242. DLL.
  243.  
  244. The function will recieve three parameters. First the modulehandle, then the
  245. windowhandle of the mainwindow, after that the parameters selected with the menu-options.
  246. If somebody wants to use this interface, he should get more informations from me.
  247. There are sample DLLs added to this packet
  248. ( Copy SUPPDEL.DLL an SUPPCPY.DLL SUPPZIP to \OS2\DLL ). Be sure to use the correct 
  249. compile-options, if you build your own DLL.
  250.  
  251. I hope you will be able to use DCOPY with this few explanations. This is a very
  252. fast and I think usefull tool for OS/2 2.x.
  253.  
  254. With the sample configuration you can use DCOPY to "unzip" your downloads and read
  255. documentations, or execute the new programm without leaving DCOPY.
  256.  
  257. If you have problems with DCOPY try to contact me.
  258.  
  259. Axel Peters
  260.