Update documentation, deprecate aws-keychain env.

`aws-keychain env` is deprecated in favor of `aws-keychain exec`

Author: pda

README.md

@@ -2,21 +2,21 @@ aws-keychain
 ============
 
 ```
-aws-keychain    (c) 2014 Paul Annesley    MIT license.
+aws-keychain    (c) 2014-2015 Paul Annesley    MIT license.
 
 Store multiple AWS IAM access keys in Mac OS X keychain.
 Check out one of them at a time into ~/.aws/credentials
 
 Manage access keys in Keychain:
   aws-keychain add <name> <access_key_id> <secret_access_key>
-  aws-keychain cat <name>
-  aws-keychain env <name>
+  aws-keychain add <name> # (interactive prompt for key and secret)
   aws-keychain ls
-  aws-keychain none
+  aws-keychain exec <name> <command ... >
+  aws-keychain cat <name>
   aws-keychain rm <name>
-  aws-keychain status
   aws-keychain use <name>
-  eval `aws-keychain env <name>`
+  aws-keychain status
+  aws-keychain none
 ```
 
 Install
@@ -53,15 +53,13 @@ $ aws-keychain ls
 personal
 work
 
+$ aws-keychain exec personal aws s3 ls
+
 $ aws-keychain use personal
 
 $ aws-keychain status
 personal: AKILNNK3OPAKMIZRQY1J
 
-$ eval `aws-keychain env work`
-$ echo "$AWS_ACCESS_KEY_ID : $AWS_SECRET_ACCESS_KEY"
-AKIJA9JFOPAKMH9AJPCJ : LBCoZPXfQNVNRJbwN92pFQ
-
 $ aws-keychain rm work
 password has been deleted.
 

aws-keychain

@@ -1,25 +1,23 @@
 #!/bin/bash
 
-## aws-keychain    (c) 2014 Paul Annesley    MIT license.
+## aws-keychain    (c) 2014-2015 Paul Annesley    MIT license.
 ##
 ## Store multiple AWS IAM access keys in Mac OS X keychain.
 ## Check out one of them at a time into ~/.aws/credentials
 ##
 ## Manage access keys in Keychain:
 ##   aws-keychain add <name> <access_key_id> <secret_access_key>
 ##   aws-keychain add <name> # (interactive prompt for key and secret)
-##   aws-keychain cat <name>
-##   aws-keychain env <name>
 ##   aws-keychain ls
-##   aws-keychain none
+##   aws-keychain exec <name> <command ... >
+##   aws-keychain cat <name>
 ##   aws-keychain rm <name>
-##   aws-keychain status
 ##   aws-keychain use <name>
-##   aws-keychain exec <name> <command ... >
-##   eval `aws-keychain env <name>`
+##   aws-keychain status
+##   aws-keychain none
 ##
-## The `security` CLI to keychain does not enumerate credentials, so
-## `aws-keychain ls` is based on an unauthoritative list on disk.
+## `aws-keychain ls` is based on an unauthoritative list on disk,
+## as the `security` CLI to keychain cannot enumerate credentials.
 
 set -euo pipefail
 
@@ -30,7 +28,7 @@ main() {
   case "${1:-}" in
     add) aws_keychain_add "$@" ;;
     cat) aws_keychain_cat "$@" ;;
-    env) aws_keychain_env "$@" ;;
+    env) aws_keychain_env "$@" ;; # deprecated for external use
     exec) aws_keychain_exec "$@" ;;
     ls) aws_keychain_ls "$@" ;;
     none) aws_keychain_none "$@" ;;