{"thread":{"id":"51744","subject":"[PATCH 1/5] Signing API: Added documentation for the new signing interface","startedAt":"2019-08-26T19:58:20Z","lastAt":"2019-08-27T18:52:20Z","messageCount":3,"participants":["Ibrahim El","brian m. carlson"],"isPatch":true,"patchVersion":1,"patchTotal":5},"messages":[{"id":"381248","messageId":"ypmMJFfJKsMOkTyunHZWwCKR1v7qaULVMMH7qlGMGN-l06V37iCnXvQLpzkr0N-1neSgCpZAtd1eKzbed2GAxvgMM15rOe-cGRsHzrglV8k=@pm.me","threadId":"51744","inReplyTo":null,"subject":"[PATCH 1/5] Signing API: Added documentation for the new signing interface","fromName":"Ibrahim El","fromEmail":"ibrahim.el@pm.me","sentAt":"2019-08-26T19:57:53Z","receivedAt":"2019-08-26T19:58:20Z","isPatch":true,"sender":{"key":"ibrahim.el@pm.me","avatar":null},"body":"From: Ibrahim El Rhezzali \n\n2f8f82549 Added documentation for the new signing interface\n\nThis contains a model document and updated Documentation detailing new interface and config aliases and their description\n\nSigned-off-by: Ibrahim El \n---\n Documentation/config/commit.txt | 12 +++--\n Documentation/config/gpg.txt | 18 ++------\n Documentation/config/push.txt | 9 +++-\n Documentation/config/signing.txt | 63 ++++++++++++++++++++++++++\n Documentation/config/tag.txt | 4 +-\n Documentation/config/user.txt | 10 ++--\n Documentation/git-am.txt | 9 ++--\n Documentation/git-cherry-pick.txt | 9 ++--\n Documentation/git-commit-tree.txt | 18 ++++----\n Documentation/git-commit.txt | 19 ++++----\n Documentation/git-rebase.txt | 9 ++--\n Documentation/git-revert.txt | 9 ++--\n Documentation/merge-options.txt | 5 +-\n Documentation/technical/signing-interface.png | Bin 0 -> 76116 bytes\n 14 files changed, 132 insertions(+), 62 deletions(-)\n create mode 100644 Documentation/config/signing.txt\n create mode 100644 Documentation/technical/signing-interface.png\n\ndiff --git a/Documentation/config/commit.txt b/Documentation/config/commit.txt\nindex 2c9557393..f01dc1248 100644\n--- a/Documentation/config/commit.txt\n+++ b/Documentation/config/commit.txt\n@@ -8,12 +8,14 @@ commit.cleanup::\n \ttemplate yourself, if you do this).\n \n commit.gpgSign::\n+\tDeprecated alias for 'commit.sign'.\n \n-\tA boolean to specify whether all commits should be GPG signed.\n-\tUse of this option when doing operations such as rebase can\n-\tresult in a large number of commits being signed. It may be\n-\tconvenient to use an agent to avoid typing your GPG passphrase\n-\tseveral times.\n+commit.sign::\n+\tA boolean to specify whether all commits should be cryptographically\n+\tsigned. Use of this option when doing operations such as rebase can\n+\tresult in a large number of commits being signed. It may be convenient\n+\tto use an agent to avoid typing your private key passphrase several\n+\ttimes.\n \n commit.status::\n \tA boolean to enable/disable inclusion of status information in the\ndiff --git a/Documentation/config/gpg.txt b/Documentation/config/gpg.txt\nindex f999f8ea4..3abbd36bf 100644\n--- a/Documentation/config/gpg.txt\n+++ b/Documentation/config/gpg.txt\n@@ -1,20 +1,8 @@\n gpg.program::\n-\tUse this custom program instead of \"`gpg`\" found on `$PATH` when\n-\tmaking or verifying a PGP signature. The program must support the\n-\tsame command-line interface as GPG, namely, to verify a detached\n-\tsignature, \"`gpg --verify $file - <$signature`\" is run, and the\n-\tprogram is expected to signal a good signature by exiting with\n-\tcode 0, and to generate an ASCII-armored detached signature, the\n-\tstandard input of \"`gpg -bsau $key`\" is fed with the contents to be\n-\tsigned, and the program is expected to send the result to its\n-\tstandard output.\n+\tDeprecated alias for 'signing.openpgp.program'.\n \n gpg.format::\n-\tSpecifies which key format to use when signing with `--gpg-sign`.\n-\tDefault is \"openpgp\" and another possible value is \"x509\".\n+\tDeprecated alias for 'signing.default'.\n \n gpg..program::\n-\tUse this to customize the program used for the signing format you\n-\tchose. (see `gpg.program` and `gpg.format`) `gpg.program` can still\n-\tbe used as a legacy synonym for `gpg.openpgp.program`. The default\n-\tvalue for `gpg.x509.program` is \"gpgsm\".\n+\tDeprecated alias for 'signing..program'.\ndiff --git a/Documentation/config/push.txt b/Documentation/config/push.txt\nindex 0a0e00056..1443b0d31 100644\n--- a/Documentation/config/push.txt\n+++ b/Documentation/config/push.txt\n@@ -61,13 +61,18 @@ push.followTags::\n \t`--no-follow-tags`.\n \n push.gpgSign::\n+\tDeprecated alias for 'push.sign'.\n+\n+push.sign\n \tMay be set to a boolean value, or the string 'if-asked'. A true\n-\tvalue causes all pushes to be GPG signed, as if `--signed` is\n+\tvalue causes all pushes to be signed, as if `--signed` is\n \tpassed to linkgit:git-push[1]. The string 'if-asked' causes\n \tpushes to be signed if the server supports it, as if\n \t`--signed=if-asked` is passed to 'git push'. A false value may\n \toverride a value from a lower-priority config file. An explicit\n-\tcommand-line flag always overrides this config option.\n+\tcommand-line flag always overrides this config option. The\n+\tsigning format used is specified by 'signing.default' which\n+\tdefaults to \"openpgp\" and uses \"`gpg`\" to create the signatures.\n \n push.pushOption::\n \tWhen no `--push-option=