threads / patch / 31616

patchDocumentation: Document signature showing options

Subject: [PATCH] Documentation: Document signature showing options

## tl;dr

2 messages between Sep 20, 2012 and Sep 20, 2012. Diffs are folded; open one to read it.

replies: 1people: 2as markdown or json

Stephen Boyd· Sep 20, 2012, 08:10 UTC · lore

The pretty formats for GPG signatures were introduced but never documented. Use the documentation from the commit that introduced them. Do the same for the --show-signature option added to git log and friends.

Signed-off-by: Stephen Boyd <bebarino@gmail.com>
---
I had to google for --show-signature one too many times.
 Documentation/pretty-formats.txt | 3 +++
 Documentation/pretty-options.txt | 4 ++++
 2 files changed, 7 insertions(+)
Show changes to 2 files +7 −0

Documentation/pretty-formats.txt, Documentation/pretty-options.txt

diff --git a/Documentation/pretty-formats.txt b/Documentation/pretty-formats.txt
index e3d8a83..d9edded 100644
--- a/Documentation/pretty-formats.txt
+++ b/Documentation/pretty-formats.txt
@@ -130,6 +130,9 @@ The placeholders are:
 - '%b': body
 - '%B': raw body (unwrapped subject and body)
 - '%N': commit notes
+- '%GG': raw verification message from GPG for a signed commit
+- '%G?': show either "G" for Good or "B" for Bad for a signed commit
+- '%GS': show the name of the signer for a signed commit
 - '%gD': reflog selector, e.g., `refs/stash@{1}`
 - '%gd': shortened reflog selector, e.g., `stash@{1}`
 - '%gn': reflog identity name
diff --git a/Documentation/pretty-options.txt b/Documentation/pretty-options.txt
index 2a3dc86..5e49942 100644
--- a/Documentation/pretty-options.txt
+++ b/Documentation/pretty-options.txt
@@ -66,3 +66,7 @@ being displayed. Examples: "--notes=foo" will show only notes from
 --[no-]standard-notes::
 	These options are deprecated. Use the above --notes/--no-notes
 	options instead.
+
+--show-signature::
+	Check the validity of a signed commit object by passing the signature
+	to `gpg --verify` and show the output.
-- 
1.7.12.1.382.gb0576a6.dirty

← back to recent threads