# [PATCH] docs: document credential.helper allowed values 3 messages from 2020-05-05 to 2020-05-06. Participants: brian m. carlson, Carlo Marcelo Arenas Belón, Jeff King. Thread: https://gitlist.dev/t/53406 ## brian m. carlson, 2020-05-05 23:12 Subject: [PATCH] docs: document credential.helper allowed values Message-ID: <20200505231226.1280264-1-sandals@crustytoothpaste.net> URL: https://gitlist.dev/e/20200505231226.1280264-1-sandals%40crustytoothpaste.net ``` gitcredentials(7) already mentions several possible invocations that one can use as the value for credential.helper. However, many people are not aware that there are other options than a simple credential helper name, so let's place some explanatory text in the documentation for credential.helper as well. We still refer the user to gitcredential(7) for additional explanations and helpful examples. Signed-off-by: brian m. carlson --- Documentation/config/credential.txt | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/Documentation/config/credential.txt b/Documentation/config/credential.txt index 60fb3189e1..9d01641c28 100644 --- a/Documentation/config/credential.txt +++ b/Documentation/config/credential.txt @@ -1,9 +1,13 @@ credential.helper:: Specify an external helper to be called when a username or password credential is needed; the helper may consult external - storage to avoid prompting the user for the credentials. Note - that multiple helpers may be defined. See linkgit:gitcredentials[7] - for details. + storage to avoid prompting the user for the credentials. This is + normally the name of a credential helper with possible + arguments, but may also be an absolute path with arguments or, if + preceded by `!`, shell commands. ++ +Note that multiple helpers may be defined. See linkgit:gitcredentials[7] +for details and examples. credential.useHttpPath:: When acquiring credentials, consider the "path" component of an http ``` ## Carlo Marcelo Arenas Belón, 2020-05-06 00:30 Subject: Re: [PATCH] docs: document credential.helper allowed values Message-ID: <20200506003029.GB49541@Carlos-MBP> URL: https://gitlist.dev/e/20200506003029.GB49541%40Carlos-MBP In-Reply-To: <20200505231226.1280264-1-sandals@crustytoothpaste.net> ``` On Tue, May 05, 2020 at 11:12:26PM +0000, brian m. carlson wrote: > gitcredentials(7) already mentions several possible invocations that one > can use as the value for credential.helper. However, many people are > not aware that there are other options than a simple credential helper > name, so let's place some explanatory text in the documentation for > credential.helper as well. > > We still refer the user to gitcredential(7) for additional explanations > and helpful examples. > > Signed-off-by: brian m. carlson > --- > Documentation/config/credential.txt | 10 +++++++--- > 1 file changed, 7 insertions(+), 3 deletions(-) > > diff --git a/Documentation/config/credential.txt b/Documentation/config/credential.txt > index 60fb3189e1..9d01641c28 100644 > --- a/Documentation/config/credential.txt > +++ b/Documentation/config/credential.txt > @@ -1,9 +1,13 @@ > credential.helper:: > Specify an external helper to be called when a username or > password credential is needed; the helper may consult external > - storage to avoid prompting the user for the credentials. Note > - that multiple helpers may be defined. See linkgit:gitcredentials[7] > - for details. > + storage to avoid prompting the user for the credentials. This is > + normally the name of a credential helper with possible > + arguments, but may also be an absolute path with arguments or, if > + preceded by `!`, shell commands. > ++ > +Note that multiple helpers may be defined. See linkgit:gitcredentials[7] > +for details and examples. what about something even simpler, to encourage people to go see the full range of options and hopeful find a fitting example in gitcredentials? "This is usually a credential helper application with possible arguments but might also be a simple shell one liner for the simplest uses" with the Note following as you suggested. Carlo PS. I suspect a sample like the one you provided for smtp would be very useful there, specially if using an encrypted storage of sort. ``` ## Jeff King, 2020-05-06 16:27 Subject: Re: [PATCH] docs: document credential.helper allowed values Message-ID: <20200506162758.GC1275237@coredump.intra.peff.net> URL: https://gitlist.dev/e/20200506162758.GC1275237%40coredump.intra.peff.net In-Reply-To: <20200505231226.1280264-1-sandals@crustytoothpaste.net> ``` On Tue, May 05, 2020 at 11:12:26PM +0000, brian m. carlson wrote: > gitcredentials(7) already mentions several possible invocations that one > can use as the value for credential.helper. However, many people are > not aware that there are other options than a simple credential helper > name, so let's place some explanatory text in the documentation for > credential.helper as well. > > We still refer the user to gitcredential(7) for additional explanations > and helpful examples. Yeah, this seems like an improvement to me. -Peff ```