README for KeyChain; http://www.gentoo.org/projects/keychain
Copyright 2001 Gentoo Technologies, Inc.; Distributed under the GPL

RELEASE NOTES (See "ChangeLog" for more info):

Keychain 2.0.2 contains a fix for the handling of ssh-askpass; SSH_ASKPASS now
needs to be set to enable askpass functionality.

Keychain 2.0.1 contains Solaris, Tru64 and MacOS X fixes, "--help" fixes, and
compatibility with x11-ssh-askpass.

Keychain 2.0 contains HP-UX and Cygwin fixes (Cygwin support is now inside the
main keychain script), and now stores keychain files in the ~/.keychain/
directory for tidiness. New filenames too: ~/.keychain/sh-${HOSTNAME} and
~/.keychain/csh-${HOSTNAME}. Keychain 2.0 also contains a bunch of additional
fixes and performance improvements, and the --local option has been
depreciated. Added the --dir option so that you can specify an alternate
location for keychain to look for the .keychain directory: "keychain --dir
/var/foo /path/to/my/key" will cause keychain to look for /var/foo/.keychain.

Keychain 1.9 contains fixed Solaris support and a new "keychain.cygwin" script
for Cygwin systems.  Sorry for the long delay in releasing this one; I've been
busy :)

Keychain 1.8 contains many shell compatibility improvements and various other
fixes, improved "lockfile" settings, improved detection of failed passphrase
attempts, the new ability to query public keys if the private key doesn't
contain a fingerprint, a quiet mode fix, and a new "--local" option for non-NFS
users who don't want to have the hostname appended to keychain's dot files.

Keychain 1.7 will use procmail's lockfile command if available to serialize the
startup of multiple keychain processes; this is a good thing if you have
multiple xterms opening simultaneously when you start X.  This new feature
prevents multiple instances of ssh-agent from mistakenly being started.  To
enable this feature, install procmail on your system.  We also now have a
ssh-agent kill fix, a Solaris output fix, Darwin/MacOS X fix, FreeBSD output
fix, new short-style options (-k/-h for --stop and --help), and a new
--quiet/-q option for less-verbose output.

Keychain 1.6 will now try to add multiple keys at once, so that if you have
two keys with the same passphrase, you only need to type in the passphrase
once.  Also contains a /usr/ucb Solaris path compatibility fix.

Keychain 1.5 contains a number of shell compatibility fixes for Solaris, IRIX,
and various other cleanups and optimizations.  If we are not universally sh-
compatible at this point, we are extremely close.

Keychain 1.4 *should* now be compatible with Linux, BSD, Solaris, IRIX and
hopefully many other POSIX-like environments.  Please submit any compatibility
patches to Daniel Robbins at drobbins@gentoo.org.

Keychain 1.3 and above now create ~/.ssh-agent-[hostname] files, making
KeyChain compatible with NFS-mounted home directories.  There is also a new
~/.ssh-agent-csh-[hostname] available that can be sourced by csh-based shells.

REQUIREMENTS

Keychain 1.3 and above should now be sh-compliant. Colorization features may
look weird if you're not using a vt100-compatible terminal and can be disabled
with the --nocolor option.  You can make keychain less verbose by using the -q
or --quiet option.

INSTALLATION

To install keychain, simply use the "install" command as follows:

install -m0755 keychain /usr/bin/keychain

Keychain is now installed.  Now, type "keychain --help | less -r" for
instructions on how to use keychain.  You'll find intructions for modifying
your ~/.bash_profile under the "Description" section.  For more detailed
information on keychain, be sure to visit the Gentoo Linux keychain project
page at:

http://www.gentoo.org/projects/keychain

Best Regards,

Daniel Robbins                                  <drobbins@gentoo.org>
Chief Architect/President                       http://www.gentoo.org 
Gentoo Technologies, Inc.			

