home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 May / PCO_5_97.ISO / FilesBBS / OS2 / ECLIP.ARJ / ECLIP090.ZIP / ECLIP.DOC < prev    next >
Encoding:
Text File  |  1997-03-13  |  12.3 KB  |  342 lines
  1. Extended Clipboard V0.90           Copyright (c) 1997 Hinnerk Becker, Hamburg
  2.                 
  3.         
  4.                Contents
  5.                ~~~~~~~~
  6.         
  7.             1. What is EClip
  8.             2. Legal matters
  9.             3. Installation
  10.             4. Usage
  11.             5. General configuration
  12.             6. Adjustments on single entries
  13.             7. Known problems
  14.             8. Uninstallation
  15.             
  16.  
  17.  
  18.             1. What is EClip ?
  19.                ~~~~~~~~~~~~~~~
  20.  
  21.  
  22. EClip is a replacement of the OS/2-Clipboard.
  23. The Clipboard can only store one item at time.
  24. When a new item is being copied into the clipboard, the old one gets
  25. replaced and is lost.
  26.  
  27. That's where EClip starts to work: old entries, which normally would get
  28. replaced, get automatically saved. So they don't get lost but can be made
  29. avaible to other applications with a single mouseclick. They even can be
  30. edited later with a doubleclick or be pasted by Drag&Drop into almost every
  31. PM application.
  32.  
  33. It is also possible to drop the clips on the desktop. So often needed
  34. textclips and bitmaps are easily accessable and can simply be inserted
  35. into any application.
  36.  
  37. EClip offers new and improved functions to use the clipboard more efficiently.
  38.  
  39. Because extensive changing between source and destination is no longer
  40. required, the clipboard becomes an even more universal aid. With EClip it
  41. is possible to copy all needed clips into the clipboard first and paste them
  42. into the destination application later.
  43.  
  44.  
  45.             2. Legal matters
  46.                ~~~~~~~~~~~~~
  47.  
  48. EClip is Shareware. It may be tested and used for 14 days free of charge, then
  49. it has to be registered. (see ORDER.FRM)
  50. It is not permitted to use an unregistered copy of EClip as soon as the
  51. evaluation period is expired.
  52. After 14 days a reminder will be displayed, when the EClip folder is opened.
  53.  
  54. The registration fee is $12 .
  55.  
  56. The program may only be distributed as the unmodified ZIP archive.
  57.  
  58. The user installs, uses and uninstalls Extended Clipboard at his own risk.
  59. The author cannot be held responsible for any damage, eg. dataloss, caused
  60. by the installation, usage and uninstallation of Extended Clipboard.
  61.  
  62. There is no warrenty of any kind for the function of Extended Clipboard or
  63. any part of Extended Clipboard.
  64.  
  65. Of course EClip has been extensivly tested and improved. Nevertheless
  66. faults can't be ruled out.
  67. The author would be pleased to get bugreports or suggestions
  68. by email and will try to solve possible problems.
  69. For the current addresses see below.
  70.  
  71.  
  72.  
  73.  
  74.             3. Installation
  75.                ~~~~~~~~~~~~
  76.  
  77.  
  78. The installation is carried out by INSTALL.EXE. When this program has started,
  79. a destination path has to be entered. If that path does not exist,
  80. it will be created by the installation program. All required *.DLL files will
  81. be copied into the specified directory. The installation/uninstallation
  82. programs and the documentation will NOT be copied !
  83.  
  84. Since EClip exclusively consists of DLLs, the LIBPATH in the config.sys has
  85. to point to the installation path. If the installation path is not included in
  86. the current LIBPATH, the installation program will ask, if it should add it
  87. automatically.
  88.  
  89. So there is either the possiblity to install EClip to an installation path
  90. that is already included in the LIBPATH (eg. \OS2\APPS\DLL) or to add the
  91. installation path to the LIBPATH statement in the CONFIG.SYS.
  92.  
  93. The probably most efficient way to install EClip is:
  94. - Unpack the EClip-archive into the installations path
  95. - Start INSTALL.EXE in this directory
  96.  
  97. In that case the path will be added to 
  98. the LIBPATH and all EClip files remain in one directory.
  99.  
  100. Now the first part of the installation has been completed. The second part
  101. will automatically start with the next system start:
  102. A new folder, called "Extended Clipboard /2", will be placed on the desktop.
  103. Now the full installation has been completed.
  104.  
  105.  
  106.  
  107.  
  108.              4. Usage
  109.                 ~~~~~
  110.  
  111.  
  112. As long as the new EClip folder is closed, EClip remains without function:
  113. No entries of the clipboard will be saved - the clipboard operates as usual.
  114. Only if the EClip folder is open, every new entry in the clipboard will be
  115. stored and saved in this folder.
  116.  
  117. Normally the last 'cut' or 'copied' data is the next to be inserted into an 
  118. application. By marking an entry in the EClip folder the next one to be
  119. inserted  can be chosen.
  120.  
  121. Of course it is possible - as usual with OS/2 - to mark several entries with
  122. the pressed mouse button.
  123. Pressing CTRL while marking allows to select multiple single entries.
  124.  
  125. Holding SHIFT while clicking on an entry will mark all entries between the
  126. last marked entry and the one clicked on.
  127.  
  128. A doubleclick on an entry opens the default application for this type of data.
  129. So the contents of an entry can be changed later.
  130.  
  131. By Drag&Dropping a text that has been saved in EClip can easily be inserted 
  132. into almost any PM - application. (Dragging with the right mouse button, 
  133. dropping over the destination)
  134.  
  135. Autopaste allows to insert entries automatically by hotkeys. After an entry
  136. has been inserted, the next entry in the EClip folder is chosen to let the
  137. next Autopaste action insert just this (the next) entry.
  138. So several old clipboard entries can be placed in the application one after
  139. the other.
  140.  
  141. The hotkeys are CTRL-ALT-CursorUp and CTRL-ALT-CursorDown.
  142.  
  143.  
  144.  
  145.  
  146.              5. General Configuration
  147.                 ~~~~~~~~~~~~~~~~~~~~~
  148.  
  149.  
  150. EClip can be configured on settings pages of the folder .
  151. (contextmenu is accessable by pressing right mousebutton over the icon 
  152. of the EClip folder)
  153.  
  154. On the first settings page ( EClip / View  1 of 2) general adjustments can be
  155. made:
  156.  
  157.  
  158.  
  159. - Delete Clips
  160.   Automatic deletion of old clipboard entries if there are more than a given
  161.   number and / or the entries are older than a given number of days.
  162.  
  163. - Miscellaneous / Cutsound:
  164.   Sound that will be played if a new item is placed in EClip.
  165.  
  166. - Miscellaneous / Always-on-top framebutton:
  167.   A special button can be inserted in the EClip titlebar. With that button
  168.   the EClip window can be made floating above all other windows always.
  169.  
  170. - Miscellaneous / Show bitmaps on folderbackground
  171.   A bitmap saved in EClip can be displayed on the background of the EClip
  172.   folder by simply marking it.
  173.  
  174. - Miscellaneous / Autopaste
  175.   Can be enabled or disabled. (see 'Usage')
  176.  
  177. On the next settings page (EClip/View  Page 2 / 2) the (details)view of the
  178. EClipfolder can be adjusted. On the known settings page different catagories
  179. of information can be chosen.
  180.  
  181.  
  182. On the third page (Clips  Page 1 / 2) the default settings for newly created
  183. EClip entries of the type 'text' can be specified.
  184. For the adjustment of already existing entries see below.
  185. ( 'Adjustments on single entries' )
  186.  
  187. - Store clips in folder:
  188.   Should EClip save Clips of type 'text' in the EClip folder ?
  189.  
  190. - Drag&Drop:
  191.   Should it be possible to drag&drop items on PM-applications ?
  192.   Which mode should be used ?
  193.  
  194.   Normally all PM-Applications which support the OS/2 Clipboard are supposed
  195.   to work with the default mode 'Use Clipboard', in which the key combination
  196.   SHIFT-Insert is simulated.
  197.   If it does not work, it might be helpful to give 'Simulate input' a try.
  198.   Here every single pressing of the keys will be simulated. This could cause
  199.   complications, because it is theoretically possible to answer security
  200.   questions automatically by dropping a clip on an application. Dataloss could
  201.   be the consequence !
  202.  
  203. - Default title / Autosynchronize
  204.   Should the title of an entry be automatically adjusted to its content ?
  205.  
  206.   The entries of the EClip folder are the names of single files. These files
  207.   have - as any file-  besides the name also a content. The filename can
  208.   automatically be produced in such a way  that it represents the first
  209.   eg. 80 characters of the content. So it is guaranteed that an old entry of
  210.   the clipboard can be recognized in the EClip folder by its title.
  211.  
  212.   When an entry in the EClipfolder is edited, its title may differ from its
  213.   content. With this global setting it is possible to specify if the title of
  214.   the entry should be automatically adjusted. It is also possible to specify
  215.   the maximal length of the generated title.
  216.  
  217.   These adjustements can be made seperately for every single item.
  218.   (see 'Adjustments on single entries')
  219.  
  220.     Note:
  221.         In general the title of an entry is generated from the first
  222.         characters of its content. Exceptions:
  223.  
  224.             * linefeed will be replaced through ''
  225.             * if the first character is '#' or  '!' it will be
  226.                replaced by '@'
  227.             * '{}' will be replaced by '[]'
  228.  
  229. - Default types:
  230.  
  231. The WPS-datatype of textclips can be chosen.
  232. The preset type is 'Plain Text'. By default all clips of that
  233. type are associated with the system editor 'E'. It is possible
  234. to change this association in the settings of the systemeditor.
  235.  
  236. Instead of giving the WPS-datatype 'Plain Text' to new clips, any other
  237. datatype can be chosen. If the typename does already exist, a
  238. doubleclick on an EClip item will open the application, associated
  239. with that type.
  240.  
  241. It is also possible to create a new datatype.
  242. The new datatype has to be added to the WPS-typelist. That can be done
  243. on the settings page 'association' of any program object.
  244. The association of the datatype can be set here, too.
  245.  
  246. To give more than one WPS-datatype to the clips, they have to
  247. be seperated by ','. Superfluous blanks have to be avoided.
  248.  
  249. Example:
  250. 'Plain Text,TextClip' would add both applications associated
  251. with these types to the contextmenu of new clips.
  252.  
  253.  
  254.  
  255. On the fourth page (Clips Page  2 / 2) the default settings for entries of
  256. the type 'bitmap' can be specified. For the adjustment of already existing
  257. entries see below. ( 'Adjustments on single entries' )
  258.  
  259. - Store clips in folder:
  260.   Should EClip save clips of type 'bitmap' in the EClip folder ?
  261.  
  262. - Default types:
  263.   The meaning of this field is described in detail in 'Clips  Page 1 / 2'.
  264.   The datatype of textclips can be set on this page. The default type is
  265.   'Bitmap'.
  266.  
  267.  
  268.             6. Adjustments on single entries
  269.                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  270.  
  271. Every item in the EClip folder has got its own settingspage. It can be
  272. reached via the contextmenu (press right mousebutton over item -> Settings).
  273. The available options on this page depend on the datatype. In contrast to the
  274. adjustments made in 'General Configuration', entries can be configured
  275. personally here.
  276. Some options can also be reached via the contextmenu.
  277.  
  278. - Title / Autosynchronize and Max length
  279.   As already described before (see 'General Configuration') the automatic
  280.   generation of the title of the item can be enabled or disabled.
  281.   The length of the title can be chosen, too.
  282.  
  283. - Default open action
  284.   A doubleclick on the entry either opens the default application to view or
  285.   edit its content or copies it to the clipboard. This might be useful,
  286.   because it is possible, to drag the item on the desktop.
  287.   Warning: Don't try to use this function with a shadow of an clip that is 
  288.             stored in the EClip folder !
  289.  
  290. - Miscellaneous / Don't delete
  291.   In the global settings it is specified, when an entry is 'old'. Old items 
  292.   will be deleted automatically. If this flag is set, the entry will not be 
  293.   deleted, even if it is old.
  294.  
  295.  
  296.             7. Known problems
  297.                ~~~~~~~~~~~~~~
  298.  
  299. - Viewing the clipboard
  300.   The clipboard viewer included in OS/2 does not cooperate with clipboard
  301.   extensions like EClip. If the viewer is opened after the EClip-folder
  302.   has been opened, EClip will not receive clips anymore.
  303.   The Eclip folder has to be closed and reopened.
  304.  
  305.   To use EClip and the clipboard viewer together, the viewer has
  306.   to be started first.
  307.  
  308. - Bitmaps and text only
  309.   EClip currently supports clips of the types 'text' and 'bitmap' only.
  310.   It would be possible to support other clipboard formats if there is demand.
  311.   Simply send an email to the author.
  312.  
  313.  
  314.             8. Uninstallation
  315.                ~~~~~~~~~~~~~~
  316.  
  317. EClip can be uninstalled by UNINST.EXE. It will unregister all EClip-
  318. classes and delete all EClip entries in the INI files.
  319.  
  320. It will not delete the installation path, and it will not remove an
  321. eventually added path from the LIBPATH.
  322.  
  323.  
  324. The auther can be reached via EMail:
  325.  
  326. hbecker@bigfoot.com                     (Internet)
  327. Hinnerk Becker@2:240/5245.7             (Fido-Net)
  328.  
  329. or via SnailMail:
  330.  
  331. Hinnerk Becker
  332. Kortenwisch 5c
  333. 22397 Hamburg
  334. Germany
  335.  
  336. I would like to express my thanks to Bernd Troszynski for
  337. many helpful suggestions, tips and the writing of this
  338. documentation.
  339.  
  340. Hinnerk Becker, March 1997
  341.  
  342.