{"thread":{"id":"53406","subject":"[PATCH] docs: document credential.helper allowed values","startedAt":"2020-05-05T23:13:07Z","lastAt":"2020-05-06T16:28:01Z","messageCount":3,"participants":["brian m. carlson","Carlo Marcelo Arenas Belón","Jeff King"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"397149","messageId":"20200505231226.1280264-1-sandals@crustytoothpaste.net","threadId":"53406","inReplyTo":null,"subject":"[PATCH] docs: document credential.helper allowed values","fromName":"brian m. carlson","fromEmail":"sandals@crustytoothpaste.net","sentAt":"2020-05-05T23:12:26Z","receivedAt":"2020-05-05T23:13:07Z","isPatch":true,"sender":{"key":"sandals@crustytoothpaste.net","avatar":"https://avatars.githubusercontent.com/u/497054?v=4"},"body":"gitcredentials(7) already mentions several possible invocations that one\ncan use as the value for credential.helper.  However, many people are\nnot aware that there are other options than a simple credential helper\nname, so let's place some explanatory text in the documentation for\ncredential.helper as well.\n\nWe still refer the user to gitcredential(7) for additional explanations\nand helpful examples.\n\nSigned-off-by: brian m. carlson <sandals@crustytoothpaste.net>\n---\n Documentation/config/credential.txt | 10 +++++++---\n 1 file changed, 7 insertions(+), 3 deletions(-)\n\ndiff --git a/Documentation/config/credential.txt b/Documentation/config/credential.txt\nindex 60fb3189e1..9d01641c28 100644\n--- a/Documentation/config/credential.txt\n+++ b/Documentation/config/credential.txt\n@@ -1,9 +1,13 @@\n credential.helper::\n \tSpecify an external helper to be called when a username or\n \tpassword credential is needed; the helper may consult external\n-\tstorage to avoid prompting the user for the credentials. Note\n-\tthat multiple helpers may be defined. See linkgit:gitcredentials[7]\n-\tfor details.\n+\tstorage to avoid prompting the user for the credentials. This is\n+\tnormally the name of a credential helper with possible\n+\targuments, but may also be an absolute path with arguments or, if\n+\tpreceded by `!`, shell commands.\n++\n+Note that multiple helpers may be defined. See linkgit:gitcredentials[7]\n+for details and examples.\n \n credential.useHttpPath::\n \tWhen acquiring credentials, consider the \"path\" component of an http\n"},{"id":"397160","messageId":"20200506003029.GB49541@Carlos-MBP","threadId":"53406","inReplyTo":"20200505231226.1280264-1-sandals@crustytoothpaste.net","subject":"Re: [PATCH] docs: document credential.helper allowed values","fromName":"Carlo Marcelo Arenas Belón","fromEmail":"carenas@gmail.com","sentAt":"2020-05-06T00:30:29Z","receivedAt":"2020-05-06T00:30:33Z","isPatch":true,"sender":{"key":"carenas@gmail.com","avatar":"https://avatars.githubusercontent.com/u/76036?v=4"},"body":"On Tue, May 05, 2020 at 11:12:26PM +0000, brian m. carlson wrote:\n> gitcredentials(7) already mentions several possible invocations that one\n> can use as the value for credential.helper.  However, many people are\n> not aware that there are other options than a simple credential helper\n> name, so let's place some explanatory text in the documentation for\n> credential.helper as well.\n> \n> We still refer the user to gitcredential(7) for additional explanations\n> and helpful examples.\n> \n> Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net>\n> ---\n>  Documentation/config/credential.txt | 10 +++++++---\n>  1 file changed, 7 insertions(+), 3 deletions(-)\n> \n> diff --git a/Documentation/config/credential.txt b/Documentation/config/credential.txt\n> index 60fb3189e1..9d01641c28 100644\n> --- a/Documentation/config/credential.txt\n> +++ b/Documentation/config/credential.txt\n> @@ -1,9 +1,13 @@\n>  credential.helper::\n>  \tSpecify an external helper to be called when a username or\n>  \tpassword credential is needed; the helper may consult external\n> -\tstorage to avoid prompting the user for the credentials. Note\n> -\tthat multiple helpers may be defined. See linkgit:gitcredentials[7]\n> -\tfor details.\n> +\tstorage to avoid prompting the user for the credentials. This is\n> +\tnormally the name of a credential helper with possible\n> +\targuments, but may also be an absolute path with arguments or, if\n> +\tpreceded by `!`, shell commands.\n> ++\n> +Note that multiple helpers may be defined. See linkgit:gitcredentials[7]\n> +for details and examples.\n\nwhat about something even simpler, to encourage people to go see the full\nrange of options and hopeful find a fitting example in gitcredentials?\n\n  \"This is usually a credential helper application with possible arguments\n   but might also be a simple shell one liner for the simplest uses\"\n\nwith the Note following as you suggested.\n \nCarlo\n\nPS. I suspect a sample like the one you provided for smtp would be very\n    useful there, specially if using an encrypted storage of sort.\n"},{"id":"397200","messageId":"20200506162758.GC1275237@coredump.intra.peff.net","threadId":"53406","inReplyTo":"20200505231226.1280264-1-sandals@crustytoothpaste.net","subject":"Re: [PATCH] docs: document credential.helper allowed values","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2020-05-06T16:27:58Z","receivedAt":"2020-05-06T16:28:01Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Tue, May 05, 2020 at 11:12:26PM +0000, brian m. carlson wrote:\n\n> gitcredentials(7) already mentions several possible invocations that one\n> can use as the value for credential.helper.  However, many people are\n> not aware that there are other options than a simple credential helper\n> name, so let's place some explanatory text in the documentation for\n> credential.helper as well.\n> \n> We still refer the user to gitcredential(7) for additional explanations\n> and helpful examples.\n\nYeah, this seems like an improvement to me.\n\n-Peff\n"}]}