fix documentation errors

[chaz/groupsecret] / bin / groupsecret

diff --git a/bin/groupsecret b/bin/groupsecret
index 5f13ab468b064c46d9308809bc6f10917cc4783a..3c9d1f032c54d4857e8358e9230cdce030b3a591 100755 (executable)
--- a/bin/groupsecret
+++ b/bin/groupsecret
@@ -21,12 +21,12 @@
 
 L<groupsecret> is a program that makes it easy for groups to share a secret between themselves
 without exposing the secret to anyone else. It could be used, for example, by a team to share an
-L<ansible-vault(1)> password; see L</ansible-vault> for more about this particular use case.
+L<ansible-vault(1)> password.
 
 The goal of this program is to be easy to use and have few dependencies (or only have dependencies
 users are likely to already have installed).
 
-L<groupsecret> works by encrypting a secret with a symmetric cipher protected by a secure random
+groupsecret works by encrypting a secret with a symmetric cipher protected by a secure random
 passphrase which is itself encrypted by one or more SSH2 RSA public keys. Only those who have access
 to one of the corresponding private keys are able to decrypt the passphrase and access the secret.
 
@@ -57,7 +57,7 @@ Alias: C<-h>
 
 Specify a path to a keyfile which stores a secret and keys.
 
-Defaults to the value of the environment variable C<GROUPSECRET_KEYFILE> or F<groupsecret.yml>.
+Defaults to the value of the environment variable L</GROUPSECRET_KEYFILE> or F<groupsecret.yml>.
 
 Alias: C<-f>
 
@@ -66,8 +66,7 @@ Alias: C<-f>
 Specify a path to a PEM private key. This is used by some commands to decrypt the passphrase that
 protects the secret and is ignored by commands that don't need it.
 
-Defaults to the value of the environment variable L</GROUPSECRET_PRIVATE_KEY>. If that is unset, it
-defaults to F<~/.ssh/id_rsa>.
+Defaults to the value of the environment variable L</GROUPSECRET_PRIVATE_KEY> or F<~/.ssh/id_rsa>.
 
 Alias: C<-k>
 
@@ -86,7 +85,7 @@ encrypt a new passphrase if it ever needs to be changed. Keys that are not embed
 for in the filesystem; see L</GROUPSECRET_PATH>.
 
 If the C<--update> option is used and a key with the same fingerprint is added, the new key will
-replaced the existing key. The default behavior is to skip existing keys.
+replace the existing key. The default behavior is to skip existing keys.
 
 If the keyfile is storing a secret, the passphrase protecting the secret will need to be decrypted
 so that access to the secret can be shared with the new key(s).
@@ -160,7 +159,7 @@ Aliases: (no command), C<show-secret>
 
 =head1 INSTALL
 
-There are several ways to install groupsecret to your system. First, make sure you first have the
+There are a few ways to install groupsecret to your system. First, make sure you first have the
 L</REQUIREMENTS> installed.
 
 =head2 Using cpanm
@@ -180,15 +179,6 @@ If you're installing to your system perl, you can do:
 to install the F<groupsecret> executable to a system directory, like F</usr/local/bin/groupsecret>
 (depending on your perl).
 
-=head2 Downloading just the executable
-
-You may also choose to download F<groupsecret> as a single executable, like this:
-
-    curl -OL https://raw.githubusercontent.com/chazmcgarvey/groupsecret/solo/groupsecret
-    chmod +x groupsecret
-
-This executable is fat-packed and includes all the non-core Perl module dependencies built-in.
-
 =head2 For developers
 
 If you're a developer and want to hack on the source, clone the repository and pull the
@@ -221,12 +211,6 @@ for in the filesystem based on the value of this environment variable.
 
 Defaults to C<.:keys:$HOME/.ssh>.
 
-=head1 EXAMPLES
-
-=head2 ansible-vault
-
-TODO
-
 =cut
 
 use warnings FATAL => 'all';