home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / osnap314.lha / English / oSnap.doc.text < prev    next >
Text File  |  1992-08-09  |  7KB  |  176 lines
  1.  
  2.                                     _   _                  _____
  3.                     /\        /\   | \ | |       /\       |  __ \
  4.                    /  \      / /   |  \| |      /  \      | | / /
  5.                   / /\ \     \ \   |     |     / /\ \     | |/ /
  6.                  / /  \ \     \ \  | |\  |    / /  \ \    |   /  
  7.                 / /    \ \     \ \ | | | |   / /____\ \   |  /  
  8.                / /      \ \    / / | | | |  / ________ \  | |  
  9.               / /        \ \  / /  | | | | / /        \ \ | | 
  10.               \ \________/ / / /   | | | | \ \        / / | |
  11.                \__________/  \/    |_| |_|  \/        \/  |_| v3.14
  12.  
  13.                (based on Snap version 1.3 by Mikael Karlsson)
  14.  
  15.  
  16.  
  17. 1. Description
  18. »»»»»»»»»»»»»»
  19.     oSnap let you select the text from any window and to insert it in any
  20. program which accept keyboard input.
  21.  
  22.     All parameters of the clipping and the insertion can be set and modified
  23. by a configuration window.  They can also be saved in a file.  oSnap can also
  24. clip graphics ans save them in an IFF file.
  25.  
  26.     Finally, it can also keep the serial port busy to fool BBS into thinking
  27. you're still in front of your computer when pressing needs arise.
  28.  
  29.  
  30. 2. Prerequisite
  31. »»»»»»»»»»»»»»»
  32.     ╖ The newgad, iff library and either reqtools or arp library.
  33.       (by the way, ReqTools is Copyright (c) Nico Franτois).
  34.  
  35.     ╖ The clipboard device.
  36.  
  37.  
  38. 3. Launching
  39. »»»»»»»»»»»»
  40.     To launch oSnap, you must run it in a CLI or a shell.  You can specify a
  41. configuration file and a file containing clips that were saved earlier.  The
  42. format of the clip file is simple: one clip per line...  So the syntax is:
  43.  
  44.     oSnap Config_File Clip_File
  45.  
  46.  
  47. 4. Operation
  48. »»»»»»»»»»»»
  49.     After the required file have been installed and oSnap is running, you can
  50. begin some serious text clipping.  Since all qualifier and action keys can be
  51. changed via the configuration, the following instruction assume the default,
  52. as when you start oSnap with NO configuration file.
  53.  
  54.  
  55.     The clip text, you must hold the text-qualifier (control key) and select
  56. text with the left mouse button.  If you release the qualifier before letting
  57. the mouse button go the clipping is canceled.  Graphic clipping used the same
  58. method, but with the graphic qualifier (control+left alt keys).
  59.  
  60.  
  61.     To insert clipped texts, hold the text-qualifier (control key) and press
  62. the insertion action key (i).  The last text that was clipped will be sent to
  63. the active window just like if you typed it with the keyboard.  If you want
  64. to select which clip to insert, hold the choose-text qualifier (control +
  65. left shift key) and press the insertion key (i).
  66.  
  67.  
  68.     In this case, a window will open up and let you select which clips (zero,
  69. one or more) will be inserted (the selection order is preserved).  You can
  70. also erase clips, read the clipboard, write to the clipboard, save to file or
  71. read a clip file.  To insert selected clips, either click on paste or double
  72. click on the the last clip you want to be sent.
  73.  
  74.  
  75.     It is also possible to insert clip in 'quote mode'.  All operation are
  76. identical, but prefixes ans suffixes will be added to the whole text and to
  77. each line.  You use the quote key (o) instead of the insert key (i).
  78.  
  79.  
  80.     When you clip a graphic, a window will open on the Workbench.  You can
  81. save the graphic in an IFF file by clinking on the button with a litle disk
  82. drawn upon.
  83.  
  84.  
  85.     Finally, you can steal the serial port and send spaces and backspaces to
  86. it continually to make a BBS believe that your still there when duty call...
  87. You activate it by using the text clip qualifier (control) and the thief key
  88. (t).  You can stop it by clicking on the stop button on the window that will
  89. appear.
  90.  
  91.  
  92. 5. Configuration
  93. »»»»»»»»»»»»»»»»
  94.     To make the configuration window appear, you hold the text qualifier (the
  95. control key) and the preference key (p).  The window is divided in four main
  96. area: Prefixes & suffixes, Snap parameters, keys and qualifiers.
  97.  
  98.  
  99.     The first section let you set the prefixes and suffixes which will be
  100. inserted when the citation mode is used.  You can insert clip inside of the
  101. text prefix and suffix (only the text ones, not line).  By putting a %s,
  102. oSnap will put the last text clipped at that point in the prefix or suffix.
  103. By putting %S (upper case), oSnap will let you choose which clip to insert
  104. in the prefix to the inserted clips (confused ? :-).
  105.  
  106.  
  107.     The second area (parameters) let you select preferences:
  108.  
  109.     ╖ Line length: the length of a line in quote mode.
  110.  
  111.     ╖ Handler priority: the priority of the inout handler used to analyse
  112.         what is going on.  Don't touch it if you don't know what it does.
  113.  
  114.     ╖ Character delay: the delay between each inserted character.
  115.  
  116.     ╖ Line delay: the delay between each line inserted.
  117.  
  118.     ╖ Add return: if you want a return to be inserted after the clips,
  119.         select this.
  120.  
  121.     ╖ Strip end blank: let you choose to remove blank (space and tab) at the
  122.         end of clips.
  123.  
  124.     ╖ Strip first blank: remove blank (space and tab) at the beginning of
  125.         the clips.
  126.  
  127.     ╖ xxxx snap-frame: let you choose which type of selection box will be
  128.         used to highligth text:
  129.  
  130.             ╖ Free: selection for a rectangular box.
  131.  
  132.             ╖ Line: selection of whole lines.
  133.  
  134.     ╖ Merge xxxxx: Which type of merge is used when multiple clips are
  135.         inserted:
  136.  
  137.             ╖ in one block: all clip a concatened.
  138.  
  139.             ╖ with spaces: a space is inserted between each clip.
  140.  
  141.             ╖ with returns: a return is inserted between each clip.
  142.  
  143.  
  144.     The third serie of button let you choose which keyboard key is used for
  145. insertion, quotation, steal of serial port and open up configuration window,
  146. in that order.
  147.  
  148.  
  149.     The last section let you choose which qualifier keys are used to clip
  150. text, choose clip text and graphic clipping.  You choose which one you want
  151. to modify with the first button and modify the qualifers with the other two.
  152.  
  153.  
  154.     At the bottom of the window there are four buttons.  They will let you
  155. confirm or cancel modification, save them and load them from a file.
  156.  
  157.  
  158. 6. Thanks
  159. »»»»»»»»»
  160.  
  161.     I'd like to thank:
  162.  
  163.         ╖ All the users of oSnap (especially those of the MontrΘal area)
  164.           who forced my to write this program and better it (with endless
  165.           suggestions...).
  166.  
  167.         ╖ Mikael Karlsson who wrote the original Snap on which this program
  168.           is based.
  169.  
  170.  
  171.  
  172. ||\\/\||//
  173. ||///\||\\
  174.  
  175. internet: dak@info.polymtl.ca (132.207.12.4 to 132.207.12.17)
  176.