[pass] [PATCH 2/2] Update manpage to document --only and shorthands

Olivier Mehani shtrom+zx2c4 at ssji.net
Mon May 16 09:17:02 CEST 2016

From: Olivier Mehani <shtrom at ssji.net>

Signed-off-by: Olivier Mehani <shtrom at ssji.net>
 man/pass.1 | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/man/pass.1 b/man/pass.1
index 33b6036..b1132ff 100644
--- a/man/pass.1
+++ b/man/pass.1
@@ -86,12 +86,16 @@ List names of passwords inside the tree that match \fIpass-names\fP by using the
 .BR tree (1)
 program. This command is alternatively named \fBsearch\fP.
-\fBshow\fP [ \fI--clip\fP[=\fIline-number\fP], \fI-c\fP[\fIline-number\fP] ] \fIpass-name\fP
+\fBshow\fP [ \fI--clip\fP[=\fIline-number\fP], \fI-c\fP[\fIline-number\fP] | \fI--only\fP[=\fIline-number\fP], \fI-o\fP[\fIline-number\fP], \fI\fP-1 ] \fIpass-name\fP
 Decrypt and print a password named \fIpass-name\fP. If \fI--clip\fP or \fI-c\fP
 is specified, do not print the password but instead copy the first (or otherwise specified)
 line to the clipboard using
 .BR xclip (1)
-and then restore the clipboard after 45 (or \fIPASSWORD_STORE_CLIP_TIME\fP) seconds.
+and then restore the clipboard after 45 (or \fIPASSWORD_STORE_CLIP_TIME\fP)
+seconds. If \fI--only\fP or \fI-o\fP is specified, only the first  (or otherwise
+specified) line of the password file is printed; this is useful for piping into
+other shell commands, or for use as a password-getting helper. \fI-1\fP is a
+shorthand equivalent to \fI--only=1\fP.
 \fBinsert\fP [ \fI--echo\fP, \fI-e\fP | \fI--multiline\fP, \fI-m\fP ] [ \fI--force\fP, \fI-f\fP ] \fIpass-name\fP
 Insert a new password into the password store called \fIpass-name\fP. This will

More information about the Password-Store mailing list