CommandKeys.preferences  Version 1.0  1999/05/01

CommandKeys.preferences is a Preferences.app module that lets you
tinker with applications Command-Key preferences.  It is a lot like
the Command-Key Equivalents part of Menu Preferences, except that
this module lets you set command-keys on a per-application basis.
It requires NeXTSTEP 3.0 or higher.

It comes with the source code, but is also compiled for those without a
development system.


INSTALLATION

To install without compiling: install the contents of CommandKeys.pkg
to one of the following directories:

	~/Library/Preferences 
	/LocalLibrary/Preferences (default)

To recompile and install: change into the CommandKeys/Source folder
and type "make INSTALLDIR=path install" where path is one of those
listed above.  This bundle can only be recompiled on a NEXTSTEP developer
system, not on OPENSTEP.

You should quit and restart Preferences.app for it to load the new
module.


COPYRIGHT

This program and source code are Copyright (C) 1999 Tom Hageman.

    This is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This software is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this software; see the file COPYING.  If not, write to
    the Free Software Foundation, 59 Temple Place - Suite 330,
    Boston, MA 02111-1307, USA.

Based in part on Gary Ritchie's WindowDepth.preferences module, though
thoroughly mangled since.


TODO

- add online help.


VERSION HISTORY

1.0 (May 1999)

 - German localization, contributed by David Andel <david@nexttoyou.de>


0.2 beta (April 1999)

 - show warning panel if key-equivalent is already in use when adding
   a new command key definition.

 - duplicate command / key-equivalent check is now also done against
   the system-wide definitions.
   
 - improved support for OPENSTEP: system-wide definitions are
   automatically added to app-specific ones when the default is saved to
   the user-defaults database, since for OPENSTEP apps the app-specific
   command-keys definition hides _all_ system-wide defined command-keys.
   NEXTSTEP and OPENSTEP definitions are merged (OPENSTEP command-key
   definition takes precedence.)

 - augmented Up/Down Arrow key navigation: Up/Down select the
   previous/next cell without wraparound; [Shift] Up/Down Arrow select
   to the previous/next cell with command-key definitions; [Alternate]
   and [Control] Up/Down select the first/last cell. (both are provided
   since on Intel, with NeXTXyzzy keyboard mapping, the [Alt]-arrow keys
   produce rubbish characters -- probably because Alt was remapped to
   the Control key, that produced the same rubbish in combination with
   the arrow keys...)

 - in the app browser, an `o' is shown at the right if it is an OPENSTEP
   default, and `n,o' if both NEXTSTEP and OPENSTEP versions exist(ed) for
   the app.  (NEXTSTEP-only defaults are not marked.)

 - some layout tweaks.
 

0.1 alpha (March 1999)

 - first alpha release.

 - supports both NEXTSTEP and OPENSTEP apps.

 - keyboard browser navigation features:

   - standard Up/Down Arrow key selection.

   - incremental search: typing into the associated text field selects
     the next best matching cell in the browser.

   - completion: the Escape key completes whetever is in the text field
     from the currently selected cell in the browser.