{"thread":{"id":"63714","subject":"[PATCH 0/5] docs: more improvements to sendemail documentation","startedAt":"2025-06-30T18:06:29Z","lastAt":"2025-06-30T18:07:11Z","messageCount":6,"participants":["Aditya Garg"],"isPatch":true,"patchVersion":1,"patchTotal":5},"messages":[{"id":"520941","messageId":"20250630180511.499-1-gargaditya08@proton.me","threadId":"63714","inReplyTo":null,"subject":"[PATCH 0/5] docs: more improvements to sendemail documentation","fromName":"Aditya Garg","fromEmail":"gargaditya08@proton.me","sentAt":"2025-06-30T18:05:59Z","receivedAt":"2025-06-30T18:06:29Z","isPatch":true,"sender":{"key":"gargaditya08@proton.me","avatar":null},"body":"From: Aditya Garg \n\nHi all\n\nThis patch series adds more improvements to the sendemail documentation.\n\nThe first patch links the OpenSSL's `verify(1)` manual page to the\ndocumentation of `-CAfile` and `-CApath` options, mentioned in a very\nconfusing way in the documentation. The changes are similar to what\nJunio suggested in https://lore.kernel.org/all/xmqqbjraf29c.fsf@gitster.g/\n\nThe second patch adds the `sendemail.outlookidfix` config option to the\ndocumentation, which corresponds to the `--outlook-id-fix` command line\noption. The documentation of the same was left by mistake before.\n\nThe third patch adds an OAuth2.0 credential helper link for AOL accounts\nto the documentation.\n\nThe fourth patch adds a paragraph explaining the `sendmailCmd` option of\ngit send-email, and giving users an idea of how it can be used to support\nproprietary APIs like Proton Mail API.\n\nThe last patch adds a paragraph explaining the options available for\nProton Mail, which has been increasing in popularity recently.\n\nP.S. all the patches are being sent using `git-protonmail`, linked in\nthe fourth and fifth patch!\n\nAditya Garg (5):\n docs: link OpenSSL's verify(1) manual page to know about -CAfile and\n -CApath options\n docs: add outlookidfix config option to sendemail documentation\n docs: add an OAuth2.0 credential helper for AOL accounts\n docs: add a paragraph explaining the `sendmailCmd` option of sendemail\n docs: mention possible options for Proton Mail users\n\n Documentation/config/sendemail.adoc | 9 +++--\n Documentation/git-send-email.adoc | 54 +++++++++++++++++++++++++----\n 2 files changed, 55 insertions(+), 8 deletions(-)\n\n-- \n2.50.0.windows.1\n\n\n"},{"id":"520942","messageId":"20250630180511.499-2-gargaditya08@proton.me","threadId":"63714","inReplyTo":"20250630180511.499-1-gargaditya08@proton.me","subject":"[PATCH 1/5] docs: link OpenSSL's verify(1) manual page to know about -CAfile and -CApath options","fromName":"Aditya Garg","fromEmail":"gargaditya08@proton.me","sentAt":"2025-06-30T18:06:28Z","receivedAt":"2025-06-30T18:06:34Z","isPatch":true,"sender":{"key":"gargaditya08@proton.me","avatar":null},"body":"From: Aditya Garg \n\nThe description of `--smtp-ssl-cert-path` in the git-send-email documentation\nmentions consulting OpenSSL's verify(1) manual page for details about the\n`-CAfile` and `-CApath` options. However, the way it was written was quite\nconfusing, and it didn't mention that OpenSSL's verify(1) is the manual page\nto refer to.\n\nFix this by slightly rewording the description and also add a link to the\nOpenSSL verify(1) manual page.\n\nSigned-off-by: Aditya Garg \n---\n Documentation/git-send-email.adoc | 14 ++++++++------\n 1 file changed, 8 insertions(+), 6 deletions(-)\n\ndiff --git a/Documentation/git-send-email.adoc b/Documentation/git-send-email.adoc\nindex 7bd09c254b..4208bac44c 100644\n--- a/Documentation/git-send-email.adoc\n+++ b/Documentation/git-send-email.adoc\n@@ -280,12 +280,14 @@ must be used for each option.\n \tPath to a store of trusted CA certificates for SMTP SSL/TLS\n \tcertificate validation (either a directory that has been processed\n \tby `c_rehash`, or a single file containing one or more PEM format\n-\tcertificates concatenated together: see verify(1) -CAfile and\n-\t-CApath for more information on these). Set it to an empty string\n-\tto disable certificate verification. Defaults to the value of the\n-\t`sendemail.smtpSSLCertPath` configuration variable, if set, or the\n-\tbacking SSL library's compiled-in default otherwise (which should\n-\tbe the best choice on most platforms).\n+\tcertificates concatenated together: see the description of the\n+\t`-CAfile` __ and the `-CApath` __ options of\n+\thttps://docs.openssl.org/master/man1/openssl-verify/\n+\t[OpenSSL's verify(1) manual page] for more information on these).\n+\tSet it to an empty string to disable certificate verification.\n+\tDefaults to the value of the `sendemail.smtpSSLCertPath` configuration\n+\tvariable, if set, or the backing SSL library's compiled-in default\n+\totherwise (which should be the best choice on most platforms).\n \n --smtp-user=::\n \tUsername for SMTP-AUTH. Default is the value of `sendemail.smtpUser`;\n-- \n2.50.0.windows.1\n\n\n"},{"id":"520943","messageId":"20250630180511.499-3-gargaditya08@proton.me","threadId":"63714","inReplyTo":"20250630180511.499-1-gargaditya08@proton.me","subject":"[PATCH 2/5] docs: add outlookidfix config option to sendemail documentation","fromName":"Aditya Garg","fromEmail":"gargaditya08@proton.me","sentAt":"2025-06-30T18:06:34Z","receivedAt":"2025-06-30T18:06:46Z","isPatch":true,"sender":{"key":"gargaditya08@proton.me","avatar":null},"body":"From: Aditya Garg \n\nThe documentation for command line option `--outlook-id-fix` is there in\nthe sendemail documentation, but the config option `sendemail.outlookidfix`\nwas missing. Add the same to the documentation.\n\nWhite at it, also enclose the values `true` and `false` in backticks in\nthe documentation for `sendemail.mailmap`.\n\nSigned-off-by: Aditya Garg \n---\n Documentation/config/sendemail.adoc | 9 +++++++--\n 1 file changed, 7 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/config/sendemail.adoc b/Documentation/config/sendemail.adoc\nindex 54f1248e64..4722334657 100644\n--- a/Documentation/config/sendemail.adoc\n+++ b/Documentation/config/sendemail.adoc\n@@ -31,8 +31,8 @@ sendemail.confirm::\n \tvalues.\n \n sendemail.mailmap::\n-\tIf true, makes linkgit:git-send-email[1] assume `--mailmap`,\n-\totherwise assume `--no-mailmap`. False by default.\n+\tIf `true`, makes linkgit:git-send-email[1] assume `--mailmap`,\n+\totherwise assume `--no-mailmap`. `False` by default.\n \n sendemail.mailmap.file::\n \tThe location of a linkgit:git-send-email[1] specific augmenting\n@@ -96,6 +96,11 @@ sendemail.xmailer::\n \tlinkgit:git-send-email[1] command-line options. See its\n \tdocumentation for details.\n \n+sendemail.outlookidfix::\n+\tIf `true`, makes linkgit:git-send-email[1] assume `--outlook-id-fix`,\n+\tand if `false` assume `--no-outlook-id-fix`. If not specified, it will\n+\tbehave the same way as if `--outlook-id-fix` is not specified.\n+\n sendemail.signedOffCc (deprecated)::\n \tDeprecated alias for `sendemail.signedOffByCc`.\n \n-- \n2.50.0.windows.1\n\n\n"},{"id":"520944","messageId":"20250630180511.499-4-gargaditya08@proton.me","threadId":"63714","inReplyTo":"20250630180511.499-1-gargaditya08@proton.me","subject":"[PATCH 3/5] docs: add an OAuth2.0 credential helper for AOL accounts","fromName":"Aditya Garg","fromEmail":"gargaditya08@proton.me","sentAt":"2025-06-30T18:06:40Z","receivedAt":"2025-06-30T18:06:53Z","isPatch":true,"sender":{"key":"gargaditya08@proton.me","avatar":null},"body":"From: Aditya Garg \n\nYahoo and AOL, both advertise that they support app passwords for third-party\napplications. But generating app passwords for them is broken and unreliable\nfor quite some time now. Yahoo already had an OAuth2.0 credential helper\nadded in the documentation, so I thought it would be a good idea to add one\nfor AOL accounts as well, which is more reliable and secure.\n\nSigned-off-by: Aditya Garg \n---\n Documentation/git-send-email.adoc | 3 +++\n 1 file changed, 3 insertions(+)\n\ndiff --git a/Documentation/git-send-email.adoc b/Documentation/git-send-email.adoc\nindex 4208bac44c..b31145901c 100644\n--- a/Documentation/git-send-email.adoc\n+++ b/Documentation/git-send-email.adoc\n@@ -600,6 +600,9 @@ available online. Community maintained credential helpers are also available:\n \t- https://github.com/AdityaGarg8/git-credential-email[git-credential-yahoo]\n \t (cross platform, dedicated helper for authenticating Yahoo accounts)\n \n+\t- https://github.com/AdityaGarg8/git-credential-email[git-credential-aol]\n+\t (cross platform, dedicated helper for authenticating AOL accounts)\n+\n You can also see linkgit:gitcredentials[7] for more OAuth based authentication\n helpers.\n \n-- \n2.50.0.windows.1\n\n\n"},{"id":"520945","messageId":"20250630180511.499-5-gargaditya08@proton.me","threadId":"63714","inReplyTo":"20250630180511.499-1-gargaditya08@proton.me","subject":"[PATCH 4/5] docs: add a paragraph explaining the `sendmailCmd` option of sendemail","fromName":"Aditya Garg","fromEmail":"gargaditya08@proton.me","sentAt":"2025-06-30T18:06:46Z","receivedAt":"2025-06-30T18:07:00Z","isPatch":true,"sender":{"key":"gargaditya08@proton.me","avatar":null},"body":"From: Aditya Garg \n\n`sendmailCmd` is a configuration option in `git-send-email` that allows\nusers to send emails using an external application that supports\nsendmail-like commands. This ability has been very useful to support\nproprietary email APIs without modifying the `git-send-email` codebase.\nIt is also useful for users who prefer to use another SMTP client\ninstead of the SMTP perl library used by `git-send-email`.\nThis commit adds a paragraph to the documentation explaining this\noption.\n\nSigned-off-by: Aditya Garg \n---\n Documentation/git-send-email.adoc | 29 +++++++++++++++++++++++++++++\n 1 file changed, 29 insertions(+)\n\ndiff --git a/Documentation/git-send-email.adoc b/Documentation/git-send-email.adoc\nindex b31145901c..6556f949a1 100644\n--- a/Documentation/git-send-email.adoc\n+++ b/Documentation/git-send-email.adoc\n@@ -619,6 +619,35 @@ These additional Perl modules are also required:\n https://metacpan.org/pod/Authen::SASL[Authen::SASL] and\n https://metacpan.org/pod/Mail::Address[Mail::Address].\n \n+Exploiting the `sendmailCmd` option of `git send-email`\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+\n+Apart from sending emails via an SMTP server, `git send-email` can also send\n+emails through any application that supports sendmail-like commands. You can\n+read documentation of `--sendmail-cmd=` above for more information.\n+This ability can be very useful if you want to use another application as an\n+SMTP client for `git send-email`, or if your email provider uses proprietary\n+APIs instead of SMTP to send emails.\n+\n+As an example, lets see how to configure https://marlam.de/msmtp/[msmtp], a\n+popular SMTP client found in many Linux distributions. Edit `~/.gitconfig`\n+to instruct `git-send-email` to use it for sending emails.\n+\n+----\n+[sendemail]\n+\tsendmailCmd = /usr/bin/msmtp # Change this to the path where msmtp is installed\n+----\n+\n+Links of a few such community maintained helpers are:\n+\n+\t- https://marlam.de/msmtp/[msmtp]\n+\t (popular SMTP client with many features, available for Linux and macOS)\n+\n+\t- https://github.com/AdityaGarg8/git-credential-email[git-protonmail]\n+\t (cross platform client that can send emails using the ProtonMail API)\n+\n+\t- https://github.com/AdityaGarg8/git-credential-email[git-msgraph]\n+\t (cross platform client that can send emails using the Microsoft Graph API)\n \n SEE ALSO\n --------\n-- \n2.50.0.windows.1\n\n\n"},{"id":"520946","messageId":"20250630180511.499-6-gargaditya08@proton.me","threadId":"63714","inReplyTo":"20250630180511.499-1-gargaditya08@proton.me","subject":"[PATCH 5/5] docs: mention possible options for Proton Mail users","fromName":"Aditya Garg","fromEmail":"gargaditya08@proton.me","sentAt":"2025-06-30T18:06:56Z","receivedAt":"2025-06-30T18:07:11Z","isPatch":true,"sender":{"key":"gargaditya08@proton.me","avatar":null},"body":"From: Aditya Garg \n\nProton Mail is an privacy-focused email service gaining popularity.\nUnfortunately, it does not provide an SMTP server to send emails.\nProton Mail Bridge is an official solution for paid users, and for free\nusers, a client named git-protonmail is available. Mention the same in the\ndocs.\n\nSigned-off-by: Aditya Garg \n---\n Documentation/git-send-email.adoc | 8 ++++++++\n 1 file changed, 8 insertions(+)\n\ndiff --git a/Documentation/git-send-email.adoc b/Documentation/git-send-email.adoc\nindex 6556f949a1..5335502d68 100644\n--- a/Documentation/git-send-email.adoc\n+++ b/Documentation/git-send-email.adoc\n@@ -606,6 +606,14 @@ available online. Community maintained credential helpers are also available:\n You can also see linkgit:gitcredentials[7] for more OAuth based authentication\n helpers.\n \n+Proton Mail does not provide an SMTP server to send emails. If you are a paid\n+customer of Proton Mail, you can use\n+https://proton.me/mail/bridge[Proton Mail Bridge]\n+officially provided by Proton Mail to create a local SMTP server for sending\n+emails. For both free and paid users, community maintained projects like\n+https://github.com/AdityaGarg8/git-credential-email[git-protonmail] can be\n+used.\n+\n Note: the following core Perl modules that may be installed with your\n distribution of Perl are required:\n \n-- \n2.50.0.windows.1\n\n\n"}]}