commit c19a706e594c84311b0c6537e5ea331565b71802
from: Alex Arx <aa@manpager.org>
date: Sun Nov 17 10:19:39 2024 UTC

document the GPM_<COMMAND> env variables

commit - 104ed24069bfe7e08d69cb3e5cd6789f50684cc5
commit + c19a706e594c84311b0c6537e5ea331565b71802
blob - f3ce66f0fc827874a4c498062f99de9f6a7276c6
blob + 9241223ae6a5e029fefc9caf48f4d6408590bb16
--- gpm.1
+++ gpm.1
@@ -1,4 +1,4 @@
-.Dd November 12, 2024
+.Dd November 16, 2024
 .Dt GPM 1
 .Os
 .Sh NAME
@@ -51,6 +51,13 @@ If used from a TTY without the
 .Fl m
 flag, a single line is read twice, and not echoed.
 Otherwise, an arbitrary amount of lines is read normally once.
+.Pp
+Options in the
+.Ev GPM_ADD
+environment variable are passed to
+.Nm
+.Cm add
+automatically, before any options specified on the command line.
 .It Xo
 .Cm copy
 .Op Fl d Ar delcmd
@@ -91,23 +98,58 @@ If
 is 0,
 .Ar delcmd
 is not run.
+.Pp
+Options in the
+.Ev GPM_COPY
+environment variable are passed to
+.Nm
+.Cm copy
+automatically, before any options specified on the command line.
 .It Cm ls
 List existing secrets, using the command in
 .Ev GPM_LSCMD
 if set.
+.Pp
+Options in the
+.Ev GPM_LS
+environment variable are passed to
+.Nm
+.Cm ls
+automatically, before any options specified on the command line.
 .It Cm mv Ar from Ar to
 Rename secret
 .Ar from
 to
 .Ar to .
+.Pp
+Options in the
+.Ev GPM_MV
+environment variable are passed to
+.Nm
+.Cm mv
+automatically, before any options specified on the command line.
 .It Cm rm Ar name ...
 Remove secrets specified on the command line.
 .Nm
 will ask for confirmation before each removal.
+.Pp
+Options in the
+.Ev GPM_RM
+environment variable are passed to
+.Nm
+.Cm rm
+automatically, before any options specified on the command line.
 .It Cm show Ar name
 Decrypt the secret
 .Ar name ,
 and print plaintext to stdout.
+.Pp
+Options in the
+.Ev GPM_SHOW
+environment variable are passed to
+.Nm
+.Cm show
+automatically, before any options specified on the command line.
 .El
 .Sh ENVIRONMENT
 .Bl -tag -width XDG_DATA_HOME
@@ -116,11 +158,6 @@ Shell command to invoke
 .Xr gpg 1 .
 .It Ev GPM_DIR
 Directory in which the secrets are stored.
-.It Ev GPM_LSCMD
-Shell command used for the
-.Nm
-command
-.Cm ls .
 .It Ev XDG_DATA_HOME
 If
 .Ev XDG_DATA_HOME