home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / TOOLS / ECLIP100 / eclip.doc < prev    next >
Text File  |  1997-04-20  |  14KB  |  377 lines

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