Add an edit mode that uses $EDITOR.

This allows users to edit password files using temporary files created
in /dev/shm. This commit also tidies other things up and fixes minor
bugs and griviences that should be separate commits but aren't.

Reported-by: rupa <rupa@lrrr.us>

1 files changed, 9 insertions, 0 deletions

diff --git a/man/pass.1 b/man/pass.1
index b17acd9..95b4f92 100644
--- a/man/pass.1
+++ b/man/pass.1
@@ -77,6 +77,15 @@ disable keyboard echo when the password is entered and confirm the password by a
 for it twice. If \fI--multiline\fP or \fI-m\fP is specified, lines will be read until
 EOF or Ctrl+D is reached. Otherwise, only a single line from standard in is read.
 .TP
+\fBedit\fP \fIpass-name\fP
+Insert a new password or edit an existing password using the default text editor specified
+by the environment variable \fBEDITOR\fP or using
+.BR vi (1)
+as a fallback. This mode makes use of temporary files for editing, but care is taken to
+ensure that temporary files are created in \fB/dev/shm\fP in order to avoid writing to
+difficult-to-erase disk sectors. If \fB/dev/shm\fP is not accessible, fallback to
+the ordinary \fBTMPDIR\fP location, and print a warning.
+.TP
 \fBgenerate\fP [ \fI--no-symbols\fP, \fI-n\fP ] [ \fI--clip\fP, \fI-c\fP ] \fIpass-name pass-length\fP
 Generate a new password using
 .BR pwgen (1)