
                             CloneCommandKeys

                                    by
                              John Lindwall

                           4138 Illinois St #8
                           San Diego, CA 92104

                           johnl@crash.cts.com

                               14 Feb 1992


Quick Description
=================

CloneCommandKeys is a Commodity that maps the AmigaDOS 2.04 Shell's CUT and
PASTE  commands  to  any keys.  The OS defines right-amiga-c to be COPY and
right-amiga-v  to  be PASTE; but these key combinations are cumbersome.  By
default,  CloneCommandKey  will make LEFT-amiga-c also operate as COPY, and
LEFT-amiga-v  will  also  act  as PASTE.  Thus you can copy and paste using
either Amiga-key.  Alternately, you can specify any key-mapping you like by
using ToolTypes.

This program requires AmigaDOS 2.04.

CloneCommandKeys  is  released  into  the Public Domain by the author, John
Lindwall.   I  ask  that  the  archive be kept intact with the docs and the
source code.   Bug reports should be sent to me at  johnl@crash.cts.com  or
the address above.


Requirements
============

CloneCommandKeys is a Commodity; thus it requires AmigaDOS 2.04.

I  usually  like  to  include code in my 2.04 utilities that checks to make
sure  the user is running AmigaDOS 2.04.  That way, it someone tries to run
it  under 1.3 I can print a message and gracefully exit.  I did not do this
for  this  program  since  I'm  trying  to  make the executable as small as
possible.  So be warned - it only works under 2.04.


ToolTypes
=========

CloneCommandKeys understands two special ToolTypes: COPYKEY amd PASTEKEY.

These ToolTypes can be set to whatever key-mapping you desire.  The key you
bind  to COPYKEY will act just like right-amiga-c (COPY).  The key you bind
to  PASTEKEY  will  act  just  like  right-amiga-v  (PASTE).  Note that the
standard  command  keys  will still work (right-amiga-c/v); you are gaining
the ability to hit a different key to perform the same operation.

Some examples:

COPYKEY=alt shift a
COPYKEY=f1

PASTEKEY=control space
PASTEKEY=down

If COPYKEY is not supplied by the user, it defaults to "lcommand c"

If PASTEKEY is not supplied by the user, it defaults to "lcommand v"

CloneCommandKeys  also  respects the standard CX_PRIORITY ToolType.  If not
supplied by the user, it defaults to 0.

If  CloneCommandKeys  is  placed  in  your WBStartup, you should enable the
DONOTWAIT ToolType.


Operation
=========

If  you'd  like to always have CloneCommandKeys installed, move its icon to
your  WBStartup  drawer.   Use  the WorkBench Icon/Information menu item to
modify   the   icon's   ToolTypes   as   desired.    Whenever   you   boot,
CloneCommandKeys will be installed.

If  CloneCommandKeys  is  placed  in  your WBStartup, you should enable the
DONOTWAIT ToolType.

CloneCommandKeys  is  a  Commodity  so  you can Enable, Disable, or Kill it
using the Commodities Exchange.  CloneCommandKeys does not have a window.

Sending a Control-C to CloneCommandKeys will also kill it.

Trying to run a second copy of CloneCommandKeys will fail, and will result
in the initial copy being killed.  This behavior is standard for this type
of Commodity.

NOTE:   If you accept the default key-mappings, left-amiga-v will no longer
function  as  Intuition's  "Requester  OK"  command  key.  Use the IControl
Preferences tool to change the "Requester OK" command to some other key.


Dedication
==========

CloneCommandKeys is dedicated to my loving wife, Deanne.

The  inspiration  for this program came from a series of postings on Usenet
where  various  people  complained about needing 2 hands to perform CUT and
PASTE  in  the  Shell.  I hope this program is useful to them, and everyone
else.


Version History
===============

1.0     Initial release of CloneCommandKeys. JWL 14 Feb 1992

End of CloneCommandKeys.doc
