home *** CD-ROM | disk | FTP | other *** search
/ Amiga Times / AmigaTimes.iso / internet / Term / Extras / Tools / StringClip / StringClip.doc < prev    next >
Encoding:
Text File  |  1998-10-06  |  3.9 KB  |  119 lines
  1. ----------------------------------------------------------------------------
  2.  
  3.                                 StringClip 1.1
  4.  
  5. ----------------------------------------------------------------------------
  6.  
  7.  
  8. The files in this archive were written by Nicola Salmoria and are freely
  9. distributable as long as the archive remains intact, and only a nominal fee
  10. is charged for its distribution.
  11.  
  12. This software is provided "AS IS" without warranty of any kind, either
  13. expressed or implied. By using it, you agree to accept the entire risk as to
  14. the quality and performance of the program.
  15.  
  16. Comments, suggestions and bug reports are welcome.
  17.  
  18.  
  19.    Nicola Salmoria
  20.    Via Piemonte 11
  21.    53100 Siena   ITALY
  22.  
  23.    E-Mail: MC6489@mclink.it
  24.  
  25.  
  26. Overview
  27. --------
  28. StringClip is a small utility which uses a new feature of Kickstart 2.0 to
  29. provide clipboard cut & paste in standard string gadgets.
  30.  
  31. By default, the system gives you various keyboard shortcuts to control the
  32. contents of string gadgets. Some of them are:
  33.  
  34. Right Amiga - Q   Undo changes
  35. Right Amiga - X   Clear buffer
  36.  
  37. StringClip will add two new shortcuts:
  38.  
  39. Right Amiga - C   Copy buffer to clipboard
  40. Right Amiga - V   Paste from clipboard
  41.  
  42.  
  43. Usage
  44. -----
  45. Usage is exactly the same of the program "ConClip" which you can find in
  46. your standard Workbench 2.0 (or later) disk.
  47.  
  48. StringClip can only be started from CLI. The template is
  49.  
  50. CLIPUNIT=UNIT/N,OFF/S
  51.  
  52.  
  53. UNIT specifies the clipboard unit to use for cut & paste. The default is 0,
  54.      and you will usually not need to change it.
  55.  
  56. OFF  turns off StringClip.
  57.  
  58. For more info, check the ConClip description in your system manuals.
  59.  
  60.  
  61. You will probably want to start StringClip from your user-startup in order
  62. to have it available at all times. The program detaches automatically from
  63. the CLI; no need to 'run' it.
  64.  
  65.  
  66. Compatibility
  67. -------------
  68. StringClip works fine with most programs. Some exceptions are programs with
  69. bugged (and I repeat: BUGGED) custom string edit hooks. I've found two of
  70. them:
  71.  
  72. - asl.library, various versions. The 'drawer' gadget works, but the 'file'
  73. gadget will not allow cut & paste. Cut will actually work, but it will soon
  74. after be interpreted as a shortcut for the menu item "Cancel", thus leaving
  75. the requester.
  76. By the way, asl requester will also have problems with the standard Amiga-Q
  77. and Amiga-X shortcuts, if you use some international keymaps (like French).
  78.  
  79. If you experience the above problem, you can fix it using a file editor.
  80. Load the file LIBS:asl.library, search for this hex string (actual position
  81. in the file varies depending on library version)
  82.  
  83. 302A 0006 0440 0010 6710 0440 0021 670A 5340 6706 0440 0035 662C
  84.  
  85. and replace it with
  86.  
  87. 0C6C 0008 002A 673E 4E71 4E71 4E71 4E71 4E71 4E71 4E71 4E71 4E71
  88.  
  89. Commodore has been reported this bug, but it hasn't been fixed at the time
  90. of this writing.
  91.  
  92.  
  93. - term by Olaf Barthel, versions 2.4a and before, supports cut & paste by
  94. itself, but due to a bug will make a mess of the contents of the gadget if
  95. you try a paste when StringClip is active. The problem has been fixed in
  96. later versions of term.
  97.  
  98.  
  99. Note for programmers
  100. --------------------
  101. There are few examples around of a correct way to write a string edit hook,
  102. apart from the one in RKRM: Libraries. If you do write one remember that
  103. you MUST check sgwork->EditOp before making changes to the data Intuition
  104. passes you. Usually, you shouldn't make changes if sgwork->EditOp is not
  105. EO_INSERTCHAR or EO_REPLACECHAR.
  106. If you want to intercept keys pressed together with Right Amiga (for example
  107. to reuse them for menus) but leave system shortcuts like Amiga-Q or Amiga-X
  108. unchanged, NEVER use sgwork->Code to decide, checking for Q or X!!!! Use
  109. sgwork->EditOp as explained above.
  110.  
  111.  
  112. Revision History
  113. ----------------
  114. V1.0 - (v37.3, 3.12.92) First release
  115.  
  116. V1.1 - (v37.4, 16.5.93) Fixed a mungwall hit when pasting. This could be
  117.        fatal on 32-bit addressing machines (A3000 and A4000). Thanks to
  118.        Federico Giannici for the report.
  119.