home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / DCOPYPM5.ZIP / DCOPY.DOC < prev    next >
Text File  |  1993-12-10  |  10KB  |  211 lines
  1. Overview DCopy V0.9b
  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   (in future: 2:2452/109.25)
  11. Internet:      apeters@train.fido.de
  12.  
  13. News in Version 09b:
  14. - multithreading
  15. - improved PopUp-menu ( DLL-support, open without selection for e.g shell )
  16. - examine programms, befor executing them
  17. - default filemasks
  18. - default directories
  19. - some minor bug fixes
  20. - ask for next diskette, if previous is full, during copy
  21.  
  22. News V09c:
  23. - duplicate function
  24.  
  25. News V09d:
  26. - start seamless Windows-Programms
  27. - DLL-supporting Undelete
  28. - added some parameters for Popup-Menu
  29.  
  30.                 All registered Users will get Version 1.0 soon
  31.  
  32. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  33. !                                                                                 !
  34. !        The author makes no warranty for any functions of DCOPY.                 !
  35. !                                                                                 !
  36. ! Be carefull deleting Directories, because DCOPY deletes whole directory-trees,  !
  37. !                            with all subdirectories.                             !
  38. !    DCOPY V0.9d is ShareWare. If you find this software usefull, please send     !
  39. !     25.- DM (or $25 US) to the author ( so you will get a next version ).       !
  40. !                                                                                 !
  41. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  42.  
  43. Sorry, there is just a small english Dokumentation, a bigger own will follow.
  44. So here are just a few hints for using DCOPY.
  45.  
  46. Install DCOPY on your Desktop with the program-template. All Files
  47. must be in the same Directory. ( DCOPY.EXE DCOPY.TIC DCOPY.CNF DCOPY.DOC )
  48. If there are Problems with the dialogboxes, try using parameter "D".
  49. So they will be aligned to the desktop, not to the program-window.
  50.  
  51. The file-box on the left side of the window shows the Source-Directory,
  52. the right box shows the Destination-Directory.
  53. Buttons on the left side only affect Files selected in the left file-box.
  54. Buttons in the middle of the window need a source-file and a destination Directory
  55. to be selected.
  56. Buttons on the right side only affect Files selected in the right file-box.
  57.  
  58. First you must specify a Drive, so klick on the drive you want to use as the
  59. Source and Destination-Drive.
  60.  
  61. After this, the File-box will show the root-directory of the specified drive.
  62. Directories will be bounded by "[]". You can change a directory with a double-
  63. click on the Directory-name.
  64.  
  65. If you select a File or Directory the actual selected size of all files will be shown.
  66.  
  67. You can use a filemask, in order to choose interesting files for your operation.
  68. The filemask can be entered by pressing the MASK-Button.
  69.  
  70. To use more than on filemask seperate them with a colomn (";")
  71. e.g. "*.c;*.h;*.mak;*.dep" to use four filemasks.
  72.  
  73. If you are using a filemask, only matching files will be copied, deleted
  74. or shown in the specified directory.
  75.  
  76. e.g. enter filemask "*.bak".  Then select a directory (or a tree) and press
  77. the delete button. In the following Dialog "Confirm with selection" you should
  78. see your mask "*.bak". So if you press the DELETE-button only files matching
  79. your filemask will be deleted.
  80. This selection also affects the TREE-, COPY-, DELETE-, AIO-, MOVE-buttons.
  81.  
  82. The Aio-Button means: Copy Files "All in one" Directory. So all matching files
  83. in the specified directory-tree will be copied to one destination-directory.
  84.  
  85. If you have selected a file, you can use the right mouse button to open an
  86. PopUp menu. This menu will be configured with the DCOPY.CNF-file. You can
  87. start external tools, while using the selected files as parameters.
  88. There is a sample configuration included in the package.
  89.  
  90.    Popup-Menu
  91.    Edit...        , EPM.EXE, %a
  92.    Run...         , %p
  93.    !
  94.    Tool...        , %q, %q, %f
  95.    Shell...       , CMD.EXE
  96.    Attrib...      , ATTRIB.EXE , %q, %f
  97.    !
  98.    >Packer
  99.    <PKUnzip...    , PKUNZIP2.EXE, %f, %w, %o, %n, %d
  100.    <PKZip...      , PKZIP2.EXE, %q, %a, %w, %r
  101.    <PKValidate... , PKUNZIP2.EXE, -t, %-, %f
  102.    <Unzip..       , UNZIP.EXE, %f, %w, %r
  103.    !
  104.    dll...         , suppdel.dll, Supp_Del, %-, %a
  105.    #
  106.    (example popup-menu-configuration)
  107.  
  108. "Popup-Menu":   here starts the menu chapter ( other chapters will follow )
  109. "#"              ends the menu chapter, each line inside this chapter will be used
  110.                  as a menu item
  111. "!"              insert seperator
  112. ">"              Name of a Submenu ( no tools can be used )
  113. "<"              Submenu item      ( same as normal items )
  114. "Edit...":       Text of menuitem.
  115. "EPM.EXE":       Tool to start.
  116. "%a":            All selected files will be parameters for tool.
  117. "%p":            Selected File will be executed
  118. "%f":            Only first file will be parameter for tool.
  119. "%w":            Wait until tool has finished.
  120. "%r":            Refresh file-box selected ( only usefull if wait (%w) is used ).
  121. "%o":            Refresh file-box not selected ( only usefull if wait (%w) is used ).
  122. "%q":            Query paramameter with dialog-box.
  123. "%s":            Source-Directory
  124. "%d":            Destination-Directory
  125. "%n":            Do not termiante tool.
  126. "%c":            start in OS/2 Fullscreen modus
  127. "%b":            start maximized
  128. "-t", "%-":      All tokens without "%" are directly passed to the command line.
  129.                  Because some options are used without a space, this is
  130.                  the default usage.
  131.                  e.g. PKUNZIP2.EXE, -t, %f will be interpreted as
  132.                  "PKUNZIP2 -t<filename>".
  133.                  So you must use the "%-" token to insert a space in the
  134.                  commandline
  135.                  e.g. PKUNZIP2.EXE, -t, %-, %f will be interpreted as
  136.                  "PKUNZIP2 -t <filename>".
  137.  
  138. If you do not specify the directoy in the name of a tool, be shure to use it
  139. in the path enviroment variable. You must use a comma to separate the options !
  140. In the actual version there can be defined up to 50 menuitems. This is nearly
  141. no limitation. But you should use Subdirectories in order to get a small
  142. menuboard and a better overview.
  143.  
  144. DCopy is now able to start all programm types (?!). You can use OS/2, DOS, WINOS2
  145. programms or OS/2, DOS batches ( or develop your own DLL ) in your Popupitem.
  146. These executeable Files must have an apptype. If your prg. does not have one, you must
  147. use "MARKEXE.EXE" to define the right apptype. Programms even can be defined as
  148. WINDOWCOMPAT in order to use a windowed session.
  149.  
  150. You can specify predefined filemasks in the "File-Mask" chapter of the cnf-file.
  151.  
  152.    File-Mask
  153.    *.bak
  154.    *.c;*.h;*.mak;*.dep;*.rc;*.res;*.dlg;
  155.    *.exe;*.com;*.cmd
  156.    #
  157.    (example filemasks in dcopy.cnf)
  158.  
  159. New filemasks will not be saved into your cnf-file. They are only valid for your
  160. current session.
  161.  
  162. With the "S"-buttons you can "snapshot" your current directory path. So you can
  163. select your directory later once again.
  164. In order to use predefined directories there are two chapters added to the cnf-file
  165. "Source-Dir" and "Dest-Dir".
  166.  
  167.    Source-Dir
  168.    C:\TMP
  169.    D:\OS2\SYSTEM
  170.    #
  171.    Dest-Dir
  172.    A:\TEST
  173.    D:\OS2\SYSTEM
  174.    #
  175.    (example direcories in dcopy.cnf)
  176.  
  177. New directories will not be saved into your cnf-file. They are only valid for your
  178. current session.
  179. There is still a small bug if you do not specify a directory while selecting the
  180. combination box. Because I use an entry-field in order to justify the actual path
  181. to the right side and the combinationboxe just support left-justify, both fields are
  182. positioned at the same position. So the entryfield is not always refreshed when it
  183. needs refresh. To avoid this bug klick on the edges of the filebox and the path will
  184. be refreshed. ( is there a posibility to get a message when the combo-box closes ? )
  185.  
  186. If you kill an action with the "STOP"-button the second thread is killed.
  187. So there might be in incorrect display of your current directory. In order to get
  188. the actual contents use the "Refresh"-buttons.
  189.  
  190. You can create a support DLL for tools on your own. I included the posibility to call
  191. funktions from the Popupmenu in your DLL's. This feature is only interresting for
  192. users, that can build there own DLL. The last line of the popupmenu configuration
  193. shows the call of an DLL-routine. First you must specify your DLL-name ( Be sure that
  194. OS/2 will find your DLL with the LIBPATH statement ). Then you must specify the function
  195. in your DLL. The function will recieve two parameters. First the modulehandle, then the 
  196. windowhandle of the mainwindow, after that the parameters selected with the menu-options.
  197. If somebody wants to use this interface, he should get more informations from me.
  198. There is an sample DLL that opens an Request added to this packet
  199. ( Copy SUPPDEL.DLL to \OS2\DLL ). Be sure to use the correct compile-options, if you
  200. build your own DLL.
  201.  
  202. I hope you will be able to use DCOPY with this few explanations. This is a very
  203. fast and I think usefull tool for OS/2 2.x.
  204.  
  205. With the sample configuration you can use DCOPY to "unzip" your downloads and read
  206. documentations, or execute the new programm without leaving DCOPY.
  207.  
  208. If you have problems with DCOPY try to contact me.
  209.  
  210. Axel Peters
  211.