home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / cbtu101.zip / CBTU.DOC next >
Text File  |  1995-04-14  |  10KB  |  212 lines
  1. /************** ASCII text version of CBTU help file ******************/
  2.  
  3.  What is ClipBoard Text Utility?    
  4.    ClipBoard Text Utility is a 32 bit clipboard viewer for OS/2 Warp or OS/2
  5. 2.x.   It adds several features that the clipboard viewer included with Warp
  6. does not have.  Specifically, it features the ability to append text to the
  7. viewer, save text to an ASCII file, send the text to the printer, actively edit
  8. or add text to the viewer, and update either the viewer or the clipboard.  It
  9. also has the capability to start minimized and run in Auto Prompt Mode.  This
  10. allows a user to run ClipBoard Text Utility in the background and be prompted
  11. (whether to send text to printer or to append to a file ) automatically each
  12. time any text is copied into the clipboard.  ClipBoard Text Utility can save
  13. time and aggravation!
  14.  
  15.  Program Requirements    
  16.    ClipBoard Text Utility is a 32 bit OS/2 program.  It requires OS/2 Warp or
  17. OS/2 2.x.  It will NOT make any changes to ANY system or configuration files. It
  18. does NOT scatter program files or .DLL files all over creation. It creates its
  19. own .ini file in the directory where it is installed.
  20.  
  21.  Program Limitations     
  22.    ClipBoard Text Utility can only hold a maximum of 64kb text data.  It can not
  23. import bitmaps or any other data format.  Printing is also limited to a straight
  24. ASCII dump to the default print object.  It is not a word processor.
  25.  
  26.  Registration    
  27. Registration fee is $25.00 for a single registration.  Please contact me for
  28. multiple registration price listing.  Personal checks or money orders are the
  29. main accepted form of payment.   Members of COMPUSERVE may register through the
  30. SWREG program on line.  On Compuserve type GO SWREG.
  31. I will also accept checks drawn on foreign banks.  However, since banking
  32. charges may vary per country please contact me for pricing and payment
  33. information before ordering.  
  34. After sending registration fees you will be sent a CODE word that will disable
  35. the ugly SHAREWARE screen that comes up every time you start the program.  You
  36. will be registered for ALL future updates or versions of CBTU and will NOT have
  37. to pay any additional fees. Send all fees and inquiries to :  
  38.  
  39. Gary L. Robinson
  40. 600 Apt. D Mumford Dr.
  41. Troy, OH  45373
  42.  
  43. internet e-mail address ==> hkypuck@ibm.net 
  44. Compuserve ==========> 76547,503
  45.  
  46.  Installation     
  47.    ClipBoard Text Utility has no installation program.  It consists of Three
  48. files CBTU.EXE, CBTU.HLP, and ORDER.FRM.  After you unzip it, copy CBTU.EXE and
  49. CBTU.HLP to a utilities directory or where ever you want them to reside. The
  50. file ORDER.FRM is an order form to register CBTU and can be easily printed to
  51. make registering an easy and almost painless chore.  After CBTU is started for
  52. the first time it also will create another file - CBTU.INI.  This file will
  53. store your settings and program position/size coordinates.
  54.    Migrate CBTU to the desk top or use a program template to put an icon on the
  55. desktop for it.  Or you could run it from the command line to test it. Whatever
  56. serves your purpose.
  57.  
  58.  Quick Start    
  59.  
  60. To get started quickly do the following :
  61.  1. Copy CBTU.EXE and CBTU.HLP to a directory of your choice
  62.  2. Migrate it to the desktop
  63.  3. Click twice on the CBTU icon
  64.  4. Open up the system editor ( or any editor ) and load in a file
  65.  5. Highlight some text and copy it into the clipboard
  66.  6. It will appear instantly in CBTU
  67.  7. Perform a drag operation off of the text area in CBTU
  68.  8. Drop the icon on the desktop
  69.  
  70.    This gives you a quick idea on how to get going.  You could have dragged the
  71. text to the printer or to a word processor.  You can also accomplish the same
  72. through Options menu.  You can also set different settings in the Settings menu
  73. - especially the first four.  You might want to read a little more of the on
  74. line documentation before trying the Auto Prompt Mode.  See Notes on Auto Prompt
  75. Mode.
  76.    Most settings and options are plainly evident.  Settings can be toggled and
  77. will change the behavior of CBTU.  Options will cause an immediate event to
  78. happen.  
  79.  
  80.  
  81.  Main Screen    
  82.    The main screen has several things of note.  The most important of these is
  83. the ability to save clipboard text to a file by using drag and drop.  Put the
  84. mouse pointer directly on the text area ( multi-line entry field ) and press the
  85. right mouse button.  Hold it down and drag the text to the Desktop, a printer
  86. object, or a word processor.  If you drop it on the desk it will be named
  87. temp.txt.  Use direct editing ( press ALT key and click on the file name below
  88. the icon ) to change the file name to whatever you desire.
  89.    Also note that CBTU can be maximized, minimized, or sized to any shape.  it
  90. will memorize its shape and position.  One last item is that the text area can
  91. be edited by the user or set for read only status through the menu settings.    
  92.  
  93.  
  94.  Menu Items    
  95.    A listing of all the menu selections and their functions.  
  96.  
  97.  
  98.  Options    
  99.  
  100. Print
  101. This sends the contents of CBTU to the printer.  It is a straight ASCII dump and
  102. does NOT pay attention to the Word Wrap feature.  To format or do extensive
  103. manipulation save the text to an ASCII file and load into your favorite word
  104. processor.  
  105.  
  106. Save to File
  107. This gives the user a standard Save As dialog box.  Navigate the file system and
  108. save the file to whatever name and directory you wish.  
  109.  
  110. Copy CBTU to Clipboard
  111. This copies whatever is in CBTU to the actual clipboard memory area.  This is in
  112. case you do some manual editing and want to update the clipboard.  
  113.  
  114. Clear CBTU
  115. This clears only the text in the CBTU viewer - NOT the clipboard memory area.  
  116.  
  117. Clear Clipboard and CBTU
  118. This clears both the text in the CBTU viewer and the actual clipboard memory
  119. area.        
  120.  
  121.  Settings    
  122.  
  123. Read Only
  124. This will toggle the read only status of the CBTU viewer.  If you have no need
  125. to actually manually edit any of the text you can leave it checked for read
  126. only.  
  127.  
  128. Word Wrap
  129. This will toggle the word wrap feature.  It is convenient to use at times for
  130. long text lines.  Saves time not having to use the scroll bars.  However, it
  131. does NOT affect the printing in any way.  
  132.  
  133. Append Mode
  134. This toggles the Append Mode.  This allows the viewer to accumulate text that is
  135. sent to the clipboard instead of clearing it every time something is sent to it.
  136.  Append Mode can not be checked when in Auto Prompt Mode.  When Auto Prompt Mode
  137. is checked Append Mode is automatically deselected and vice-versa.  See Auto
  138. Prompt Mode below for more information.  
  139.  
  140. Add Spaces to Append Mode
  141. This gives the user the ability to add two lines ( as a spacer ) between
  142. accumulated text that is sent to the clipboard when CBTU is in Append Mode. 
  143. This will not affect the Auto Prompt Mode.  It has it's own separate facility.  
  144.  
  145. Auto Prompt Mode
  146. This toggles the Auto Prompt Mode.  When Auto Prompt Mode is checked Append Mode
  147. is deselected automatically.  Auto prompt Mode was added primarily to give the
  148. user a faster way to go through large or multiple documents and appending many
  149. segments quickly into a file or sending numerous segments to the printer.  In
  150. some ways it accomplishes much of the same functionality of the Append Mode. 
  151. CBTU is USUALLY minimized during the Auto Prompt Mode.  Every time you copy any
  152. text to the clipboard ( no matter what document or program ) it will prompt you
  153. to either append to a file or send to the printer.  See Notes on Auto Prompt
  154. Mode for more.
  155.  
  156. Minimize on Startup
  157. This will make CBTU start minimized ( or hidden ) when it first starts.  This is
  158. especially useful, but not limited, to the Auto Prompt Mode.    
  159.  
  160.  About     
  161. This is the notorious Shareware beg screen - complete with a bitmap graphic of
  162. the author.  
  163.  
  164.  Help     
  165. If you really need to know what a help selection is on a menu - go directly to
  166. DOS and STAY there.  It'll be safer for all of us.    
  167.  
  168.  Misc. Topics    
  169.    Topic or items not covered in other areas of the help file.  
  170.  
  171.  Drag and Drop     
  172.    Drag and Drop is very limited in CBTU.  I did not think it appropriate to
  173. enable dragging text files to drop onto CBTU.  It is not primarily a text editor
  174. - though I did enable it to be set Read Only or editable.  If enough users would
  175. want it, I can easily add the capability to drop files into it.    Any other
  176. suggestions on where drag and drop could be used will also be considered.
  177. Presently I don't see where else it would be useful.  
  178.  
  179.  Printing    
  180.    Printing support is very minimal.  It will send the ASCII text to the Default
  181. printer. The same effect as doing a Print command from the C prompt.  Long lines
  182. will not be wrapped and using the word wrap in the program will not affect this.
  183.  To get better or more control of printed text - drag the text to a word
  184. processor and format it as you like.  
  185.  
  186.  Notes on Auto Prompt Mode    
  187.    The Auto Prompt Mode was added mostly because of the different ways that
  188. people work.  What can be accomplished in Auto Mode usually can be done in
  189. Append Mode. It is just a matter of taste.  In Auto Prompt you may gain a little
  190. if you want to combine a number of text passages directly into a ASCII file or
  191. to quickly send a series of text notes to the printer.  Try both ways and see
  192. which you prefer.
  193.  
  194. To use Auto Prompt Mode :
  195.  1. click on Auto Prompt Mode in the Settings Menu
  196.  2. Then minimize CBTU
  197.  3. Then open a text file with an and copy some text into the clipboard
  198.  4. CBTU will prompt you to either save the text ( append to ) to an ASCII file,
  199.     send it to the printer, or Cancel 
  200.  
  201.     CBTU arbitrarily uses the file name : CBTU.TXT and puts (copies) it onto the
  202. desktop. This makes it easy to drag the file quickly to a printer object, open
  203. up, delete, etc.  You can type in another name and/or path any time you like in
  204. the entry field at the top of the Auto Prompt dialog box.   If you select the
  205. print button, the text ( what was just entered into the clipboard memory area -
  206. not what is in the file ) will be sent to the printer immediately.
  207.    Continue and copy other text items as needed.  Every time you copy any text
  208. into the clipboard memory area ( a shared memory area for the OS/2 system ) CBTU
  209. will prompt you.  When you are finished, bring up the OS/2 Window list, select
  210. CBTU, and close it.
  211.  
  212.