# [PATCH] Documentation: Document signature showing options

2 messages from 2012-09-20 to 2012-09-20. Participants: Stephen Boyd, Junio C Hamano.
Thread: https://gitlist.dev/t/31616

## Stephen Boyd, 2012-09-20 08:10

Subject: [PATCH] Documentation: Document signature showing options
Message-ID: <1348128638-26003-1-git-send-email-bebarino@gmail.com>
URL: https://gitlist.dev/e/1348128638-26003-1-git-send-email-bebarino%40gmail.com

```
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(+)

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

```

## Junio C Hamano, 2012-09-20 20:40

Subject: Re: [PATCH] Documentation: Document signature showing options
Message-ID: <7vvcf8a0nu.fsf@alter.siamese.dyndns.org>
URL: https://gitlist.dev/e/7vvcf8a0nu.fsf%40alter.siamese.dyndns.org
In-Reply-To: <1348128638-26003-1-git-send-email-bebarino@gmail.com>

```
Thanks.

```
