home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 067.lha / snipit.doc < prev    next >
Text File  |  1986-11-20  |  4KB  |  117 lines
  1. SnipIt 1.0 - Copyright (c) 1987 - Scott Evernden, All Rights Reserved
  2.  
  3.  
  4. What is SnipIt?
  5. ================
  6.  
  7. SnipIt is a shareware CLI program which allows you to copy text directly
  8. from any console window on the Amiga screen into any other window.  You
  9. mark the text you want to "snip" using the mouse.  You also use the mouse
  10. to "paste" the last snipped text into the active window.
  11.  
  12. SnipIt is a program which installs itself into the input stream handling
  13. code of AmigaDOS.  It waits for you to hold down the left-Amiga key while
  14. using the mouse.
  15.  
  16.  
  17. Running the Program
  18. ===================
  19.  
  20. This program will only run properly from the CLI.  You start it like
  21.  
  22.     > run snipit
  23.  
  24. at which point, SnipIt will install itself, and print a message.
  25.  
  26. You can remove SnipIt by
  27.  
  28.     > snipit anthing you want
  29.  
  30. In other words, type "snipit" followed by any non-blank characters.
  31.  
  32.  
  33. Marking Text to be Copied
  34. =========================
  35.  
  36. To mark text to be copied, simply depress the left-Amiga key, move the
  37. mouse pointer to a position in a console window and hold down the left
  38. mouse button.  While holding down the left mouse button you stroke to the
  39. opposite end of the text area you want to copy and then release.
  40.  
  41. Once you have released the left mouse button, SnipIt will highlight and
  42. "snapshot" the area you have marked out.
  43.  
  44.  
  45. Pasting the Copied Text
  46. =======================
  47.  
  48. You can deposit the text you copied by, again, holding down the left-Amiga
  49. key, and clicking the right mouse button.
  50.  
  51. SnipIt will inject keystroke codes into the input stream, so you can paste
  52. text into any active window which is expecting keyboard input.
  53.  
  54. You can paste copied text as many times as you want.
  55.  
  56. SnipIt will un-hilight the selected area whenever any output occurs in that
  57. window.  You can still paste the copied text, however, even though the
  58. highlighting has been removed.
  59.  
  60.  
  61. Limitations of This Version
  62. ===========================
  63.  
  64. SnipIt can only snip text from console windows.  Windows belonging to
  65. applications using Intuition directly cannot provide "snippable" text.
  66. (An example is Dave Wecker's VT100 emulator, sorry).
  67.  
  68. SnipIt will only highlight and snip text in console windows using an 8 pixel
  69. wide font.
  70.  
  71. SnipIt in its current form cannot recognize text which is highlighted,
  72. italicised, underlined, highlighted, or colored (sorry, again).
  73.  
  74. SnipIt can only recognize character codes between ASCII 32-127, so special
  75. characters (requiring the ALT key to generate) will not get recognized
  76. properly.  If SnipIt cannot figure out a character, it will substitute a '?'
  77. (question mark) character.
  78.  
  79. I have not tested this program on anything but Version 1.2 of the Amiga OS.
  80. SnipIt accesses some private and undocumented console driver data fields
  81. which may cause this program to fail on other versions of the operating
  82. system.
  83.  
  84. SnipIt appears to work properly with the ConMan replacement console handler
  85. by William Hawes.  However, SnipIt may highlight areas in a peculiar fashion
  86. in ConMan windows having the GimmeZeroZero attribute (/z).
  87.  
  88. This program will also co-operate with programs like SunMouse and others
  89. which can change window activation automatically.  However, note that
  90. each character of any pasted text will arrive in whatever window the mouse
  91. is currently in.
  92.  
  93.  
  94. Bugs
  95. ====
  96.  
  97. I have not gone to any special effort to check if Windows or Screens are
  98. closed, or otherwise disappear, while the mouse is highlighting an area.
  99. The system will likely Guru if this happens.
  100.  
  101. Others which have't been found yet.
  102.  
  103.  
  104. Help Out
  105. ========
  106.  
  107. If you like this program, you are invited to contribute anything to:
  108.  
  109. Scott Evernden
  110. 9 Courtland St.
  111. Holliston, MA 01746
  112.  
  113. plink:    SCOTT E
  114. cis:    73116,3451
  115. bix:    s_evernden
  116.  
  117.