home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / miscutil / clncmdky.lha / CloneCommandKeys.doc < prev    next >
Text File  |  1992-02-21  |  4KB  |  118 lines
  1.  
  2.                              CloneCommandKeys
  3.  
  4.                                     by
  5.                               John Lindwall
  6.  
  7.                            4138 Illinois St #8
  8.                            San Diego, CA 92104
  9.  
  10.                            johnl@crash.cts.com
  11.  
  12.                                14 Feb 1992
  13.  
  14.  
  15. Quick Description
  16. =================
  17.  
  18. CloneCommandKeys is a Commodity that maps the AmigaDOS 2.04 Shell's CUT and
  19. PASTE  commands  to  any keys.  The OS defines right-amiga-c to be COPY and
  20. right-amiga-v  to  be PASTE; but these key combinations are cumbersome.  By
  21. default,  CloneCommandKey  will make LEFT-amiga-c also operate as COPY, and
  22. LEFT-amiga-v  will  also  act  as PASTE.  Thus you can copy and paste using
  23. either Amiga-key.  Alternately, you can specify any key-mapping you like by
  24. using ToolTypes.
  25.  
  26. This program requires AmigaDOS 2.04.
  27.  
  28. CloneCommandKeys  is  released  into  the Public Domain by the author, John
  29. Lindwall.   I  ask  that  the  archive be kept intact with the docs and the
  30. source code.   Bug reports should be sent to me at  johnl@crash.cts.com  or
  31. the address above.
  32.  
  33.  
  34. Requirements
  35. ============
  36.  
  37. CloneCommandKeys is a Commodity; thus it requires AmigaDOS 2.04.
  38.  
  39. I  usually  like  to  include code in my 2.04 utilities that checks to make
  40. sure  the user is running AmigaDOS 2.04.  That way, it someone tries to run
  41. it  under 1.3 I can print a message and gracefully exit.  I did not do this
  42. for  this  program  since  I'm  trying  to  make the executable as small as
  43. possible.  So be warned - it only works under 2.04.
  44.  
  45.  
  46. ToolTypes
  47. =========
  48.  
  49. CloneCommandKeys understands two special ToolTypes: COPYKEY amd PASTEKEY.
  50.  
  51. These ToolTypes can be set to whatever key-mapping you desire.  The key you
  52. bind  to COPYKEY will act just like right-amiga-c (COPY).  The key you bind
  53. to  PASTEKEY  will  act  just  like  right-amiga-v  (PASTE).  Note that the
  54. standard  command  keys  will still work (right-amiga-c/v); you are gaining
  55. the ability to hit a different key to perform the same operation.
  56.  
  57. Some examples:
  58.  
  59. COPYKEY=alt shift a
  60. COPYKEY=f1
  61.  
  62. PASTEKEY=control space
  63. PASTEKEY=down
  64.  
  65. If COPYKEY is not supplied by the user, it defaults to "lcommand c"
  66.  
  67. If PASTEKEY is not supplied by the user, it defaults to "lcommand v"
  68.  
  69. CloneCommandKeys  also  respects the standard CX_PRIORITY ToolType.  If not
  70. supplied by the user, it defaults to 0.
  71.  
  72. If  CloneCommandKeys  is  placed  in  your WBStartup, you should enable the
  73. DONOTWAIT ToolType.
  74.  
  75.  
  76. Operation
  77. =========
  78.  
  79. If  you'd  like to always have CloneCommandKeys installed, move its icon to
  80. your  WBStartup  drawer.   Use  the WorkBench Icon/Information menu item to
  81. modify   the   icon's   ToolTypes   as   desired.    Whenever   you   boot,
  82. CloneCommandKeys will be installed.
  83.  
  84. If  CloneCommandKeys  is  placed  in  your WBStartup, you should enable the
  85. DONOTWAIT ToolType.
  86.  
  87. CloneCommandKeys  is  a  Commodity  so  you can Enable, Disable, or Kill it
  88. using the Commodities Exchange.  CloneCommandKeys does not have a window.
  89.  
  90. Sending a Control-C to CloneCommandKeys will also kill it.
  91.  
  92. Trying to run a second copy of CloneCommandKeys will fail, and will result
  93. in the initial copy being killed.  This behavior is standard for this type
  94. of Commodity.
  95.  
  96. NOTE:   If you accept the default key-mappings, left-amiga-v will no longer
  97. function  as  Intuition's  "Requester  OK"  command  key.  Use the IControl
  98. Preferences tool to change the "Requester OK" command to some other key.
  99.  
  100.  
  101. Dedication
  102. ==========
  103.  
  104. CloneCommandKeys is dedicated to my loving wife, Deanne.
  105.  
  106. The  inspiration  for this program came from a series of postings on Usenet
  107. where  various  people  complained about needing 2 hands to perform CUT and
  108. PASTE  in  the  Shell.  I hope this program is useful to them, and everyone
  109. else.
  110.  
  111.  
  112. Version History
  113. ===============
  114.  
  115. 1.0     Initial release of CloneCommandKeys. JWL 14 Feb 1992
  116.  
  117. End of CloneCommandKeys.doc
  118.