From: Eli Zaretskii <eliz@gnu.org>
To: Damien Cassou <damien@cassou.me>
Cc: magnus.henoch@gmail.com, nicolas@petton.fr, npostavs@gmail.com,
iku.iwasa@gmail.com, camalot@picnicpark.org,
gaby.launay@tutanota.com, 36052@debbugs.gnu.org,
tzz@lifelogs.com
Subject: bug#36052: 26.2.50; [PATCH] Improve auth-source-pass
Date: Fri, 14 Jun 2019 10:47:42 +0300 [thread overview]
Message-ID: <83imt8y5ep.fsf@gnu.org> (raw)
In-Reply-To: <877e9p45p7.fsf@cassou.me> (message from Damien Cassou on Thu, 13 Jun 2019 21:59:32 +0200)
> From: Damien Cassou <damien@cassou.me>
> Cc: Noam Postavsky <npostavs@gmail.com>, Magnus Henoch <magnus.henoch@gmail.com>, Ted Zlatanov <tzz@lifelogs.com>, Iku Iwasa <iku.iwasa@gmail.com>, Keith Amidon <camalot@picnicpark.org>, galaunay <gaby.launay@tutanota.com>, Nicolas Petton <nicolas@petton.fr>, Eli Zaretskii <eliz@gnu.org>
> Date: Thu, 13 Jun 2019 21:59:32 +0200
>
> diff --git a/etc/NEWS b/etc/NEWS
> index 95d7e08074..f5781fb7e5 100644
> --- a/etc/NEWS
> +++ b/etc/NEWS
> @@ -1512,6 +1512,21 @@ the new variable 'buffer-auto-revert-by-notification' to a non-nil
> value. Auto Revert mode can use this information to avoid polling the
> buffer periodically when 'auto-revert-avoid-polling' is non-nil.
>
> +** auth-source-pass
> +
> +*** New customizable variable 'auth-source-pass-filename'.
> +Allows setting the path to the password-store, defaults to
> +~/.password-store.
> +
> +*** New customizable variable 'auth-source-pass-port-separator'.
> +Specifies separator between host and port, defaults to colon ":".
> +
> +*** Minimize the number of decryptions during password lookup.
> +This makes the package usable with physical tokens requiring touching
> +a sensor for every decryption.
> +
> +*** 'auth-source-pass-get' is now autoloaded.
These are all described in the patch for the manual, right? If so,
the entries should be marked with "+++", see the beginning of NEWS for
instructions about that.
> +@itemize
> +@item @code{"gnu.org.gpg"} : No username or port in the filename means that any username and port will match.
> +@item @code{"gnu.org/rms.gpg"} : The username to match can be expressed as filename inside a directory whose name matches the host. This is useful if the store has passwords for several users on the same host.
> +@item @code{"rms@@gnu.org.gpg"} : The username can also be expressed as a prefix, separated from the host with an at-sign (@code{@@}).
> +@item @code{"gnu.org:22.gpg"} : The port (aka. service) to match can only be expressed after the host and separated with a colon (@code{:}). The separator can be changed through the @code{auth-source-pass-port-separator} variable.
> +@item @code{"gnu.org:22/rms.gpg"}
> +@item @code{"rms@@gnu.org:22.gpg"}
> +@item @code{"a/b/gnu.org.gpg"} : Entries can be stored in arbitrary directories.
> +@item @code{"a/b/gnu.org/rms.gpg"}
> +@item @code{"a/b/rms@@gnu.org.gpg"}
> +@item @code{"a/b/gnu.org:22.gpg"}
> +@item @code{"a/b/gnu.org:22/rms.gpg"}
> +@item @code{"a/b/rms@@gnu.org:22.gpg"}
> +@end itemize
Please make the text describing each @item start on a new line. Also,
it sounds like you want @table here, not @itemize. And finally,
quoting in @code is sub-optimal; would @samp (and losing the quotes)
do the job?
> +@defvar auth-source-pass-filename
> +Set this variable to a string locating the password store on the
> +disk. Defaults to @code{"~/.password-store"}.
File names or their parts should have the @file markup, not @code.
Thanks.
next prev parent reply other threads:[~2019-06-14 7:47 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-06-02 9:11 bug#36052: 26.2.50; [PATCH] Improve auth-source-pass Damien Cassou
2019-06-07 0:43 ` Noam Postavsky
2019-06-08 15:47 ` Damien Cassou
2019-06-08 16:02 ` Eli Zaretskii
2019-06-08 22:38 ` Noam Postavsky
2019-06-13 19:59 ` Damien Cassou
2019-06-13 21:23 ` Noam Postavsky
2019-06-14 7:10 ` Damien Cassou
2019-06-14 7:47 ` Eli Zaretskii [this message]
2019-06-14 16:16 ` Damien Cassou
2019-06-22 9:02 ` Eli Zaretskii
2019-06-24 7:26 ` Damien Cassou
2019-06-24 14:33 ` Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=83imt8y5ep.fsf@gnu.org \
--to=eliz@gnu.org \
--cc=36052@debbugs.gnu.org \
--cc=camalot@picnicpark.org \
--cc=damien@cassou.me \
--cc=gaby.launay@tutanota.com \
--cc=iku.iwasa@gmail.com \
--cc=magnus.henoch@gmail.com \
--cc=nicolas@petton.fr \
--cc=npostavs@gmail.com \
--cc=tzz@lifelogs.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.