home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / CLIPIT10.ZIP / CLIPIT.DOC next >
Text File  |  1990-11-06  |  7KB  |  192 lines
  1.  
  2.  
  3.  
  4. CLIPIT: An OS/2 Text Mode Clipboard Utility.
  5. ===========================================
  6.  
  7.  
  8. 1.  Legalese
  9.     --------
  10.  
  11. This program is Copyright (c) 1990, Chris Laforet and Chris Laforet
  12. Software.  The program is released by its copyright owner into the
  13. public domain for distribution as long as the distribution is free of
  14. charge (apart from minor charges to cover the cost of a diskette or
  15. normal online service charges for some BBSes) and as long as it
  16. accompanied by this document.
  17.  
  18. Use of this software for any purpose whatsoever constitutes your
  19. unqualified acceptance of the following statements:
  20.  
  21. The copyright holder makes no warranty or representation that this
  22. software will be error free.  The copyright holder hereby disclaims any 
  23. and all warranties, either expressed or implied, including but not 
  24. limited to any implied warranties of merchantability or fitness for 
  25. any particular purpose.  The user agrees to take full responsibility
  26. for the selection of and any use whatsoever made of this software.  
  27.  
  28. IN NO EVENT WILL THE COPYRIGHT HOLDER OR ANY AGENT THEREOF BE LIABLE FOR
  29. ANY DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF
  30. BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION OR 
  31. THE LIKE) ARISING OUT OF THE USE OF, INTERRUPTION IN THE USE OF, OR 
  32. INABILITY TO USE THIS SOFTWARE, EVEN IF THE COPYRIGHT HOLDER HAS BEEN 
  33. ADVISED OF ANY POSSIBILITY OR LIKELIHOOD OF SUCH DAMAGES.
  34.  
  35.  
  36.  
  37. 2.  Description
  38.     -----------
  39.  
  40. Clip It! is a small little project started by me about 6 months ago
  41. which was to become an OS/2 replacement for that neat little DOS
  42. utility published by PC Magazine called "Snipper".  It was meant to be
  43. a learning exercise in the use of shared-memory segments and with
  44. monitors.
  45.  
  46. Clip It! will run in any full-screen session and pop-up at the press of
  47. Ctrl-F8.  The user is presented with the choice of marking an area of
  48. the text screen and saving the information to a file or to a clipboard
  49. buffer, or to play-back the contents of the clipboard buffer as
  50. keystrokes in the current session.
  51.  
  52.  
  53.  
  54. 3.  Usage Notes
  55.     -----------
  56.  
  57. To start Clip It!, simply enter the name CLIPIT on the OS/2 command
  58. line and hit enter to execute it.  Alternatively you can have it
  59. automatically invoked everytime you start an OS/2 session by having the
  60. following after the invocation for CMD.EXE in the protshell line in 
  61. your CONFIG.SYS:
  62.  
  63.    /k c:\os2init.cmd
  64.  
  65. as in:
  66.  
  67.    protshell=pmshell.exe os2.ini os2sys.ini cmd.exe /k c:\os2init.cmd
  68.                                                     ^^^^^^^^^^^^^^^^^
  69.  
  70. OS2INIT.CMD can have the following statements:
  71.  
  72.    @echo off
  73.    iffull
  74.    if errorlevel 1 goto end
  75.    clipit
  76.    :end
  77.  
  78. IFFULL is a PD program floating around which returns an errorlevel if
  79. the shell is running in anything other than a full-screen text session. 
  80. If you are interested in IFFULL, you can get it from the BBS listed
  81. below.
  82.  
  83. Once Clip It! has been installed, you can pop it up by pressing
  84. Ctrl-F8.  Once popped-up, you can select if you wish to cut a segment
  85. of the screen to the clipboard or to file.  If you choose either of
  86. these, you will be presented with a large flashing cursor.  Move this
  87. using the following keys to your desired start position, and then press
  88. Enter.  You can then move to the other end of the rectangular inverse-video 
  89. area to cut.  Once this has been done, you may press Enter again to cut it 
  90. to the clipboard or to file.  
  91.  
  92. If you are planning on cutting it to file, you will then be asked to 
  93. provide a pathname for the destination file.  The cut section is
  94. APPENDED to the file if it already exists.
  95.  
  96. If you choose to paste the text from the clipboard, then you will be
  97. returned to your application and then the clipboard contents will be
  98. sent in as keystrokes.
  99.  
  100. You may also choose to uninstall the program, which means that Clip It!
  101. will be removed from monitoring the current full-screen group.  Other
  102. invocations of Clip It! in other sessions and the clipboard will be
  103. left intact (as long as this is not the only invocation of Clip It!).
  104.  
  105. You may abort most of these operations by using the Esc key.
  106.  
  107.  
  108.  
  109. 4.  Keystrokes
  110.     ----------
  111.  
  112. In the menu, you may use the up and down arrows to move the light-bar
  113. to the selection of your choice.  You may also press the option's letter
  114. as a shortcut method.  Pressing Enter selects the choice.  Pressing Esc
  115. exits the menu back to your application.
  116.  
  117. While marking text, the following keys are active:
  118.  
  119.   Up Arrow/Down Arrow  --  Move up and down by one line.
  120.   Rt Arrow/Left Arrow  --  Move right and left by one column.
  121.              Home/End  --  Move to beginning and end of the line.              
  122.             PgUp/PgDn  --  Move to the top and bottom of the screen.
  123.                   Esc  --  Abort operation.
  124.                 Enter  --  Select position as being valid.
  125.  
  126.  
  127. While entering a filename, the following keys are active:
  128.  
  129.   Rt Arrow/Left Arrow  --  Move to next or previous character.
  130.         Ctrl-Rt Arrow  --  Move to end of filename.
  131.       Ctrl-Left Arrow  --  Move to beginning of filename.
  132.                 Alt-C  --  Clear the field completely.
  133.                   Ins  --  Toggle insert mode on and off.
  134.                   Del  --  Delete character under the cursor.
  135.             Backspace  --  Delete character left of the cursor.
  136.             Esc/Alt-Q  --  Abort the operation.
  137.           Enter/Alt-X  --  Accept the filename and save screen segment.
  138.  
  139.  
  140.  
  141. 5.  Caveats!
  142.     -------
  143.  
  144. Do not clip stuff into the clipboard in another session while you are
  145. pasting the current clipboard in another one.  I need to lock this
  146. possibility out using a semaphore, but am too busy to do it right now.
  147.  
  148.  
  149.  
  150. 6.  The Future
  151.     ----------
  152.  
  153. Who knows what the future holds?  Some of the things I would like to do
  154. with Clip It! are the following:
  155.  
  156.   + Lock the clipboard with a semaphore while pasting.
  157.   + Give statistics or a view of what is in the clipboard.
  158.   + Allow configurable hotkey and colors.
  159.  
  160.  
  161. If I hear from enough of you, I might just do these things.
  162.  
  163.  
  164.  
  165. 7.  Contacting me
  166.     -------------
  167.  
  168. I am a self-employed programming consultant.  If your company needs
  169. some contract programming in C or C++ in DOS or OS/2, please feel free
  170. to contact me for more information.  If you have comments about this
  171. program feel free to drop me a line via any of the following means:
  172.  
  173.     * US Mail: Chris Laforet Software
  174.               511-D Poplar St
  175.               Graham, NC  27253
  176.    * Ma Bell: 1-919/226-6957
  177. * Compuserve: ID: 76120,110 (Chris Laforet)
  178.        * BIX: Laforet
  179.      * Genie: XTX74591
  180.    * Fidonet: 1:151/401 and 1:151/402
  181.  
  182. If you have any flames about this program, please address them to NUL.
  183.  
  184. Finally, you can call my Fidonet BBSes, one of which I am currently
  185. developing under OS/2.  I have numerous OS/2-related file areas and
  186. also tie in to the international OS/2 echo conference.  Be forewarned
  187. that I do not give first-time callers immediate access to my systems. 
  188. I must upgrade you first.  Anyway, here are the particulars:
  189.  
  190. * The Programmer's Oasis BBS   - 919/226-6984 - HST/2400/1200/300,N,8,1
  191. * The Programmer's Oasis 2 BBS - 919/226-7136 - HST/2400/1200/300,N,8,1
  192.