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