# [PATCH] Documentation: GPG capitalization 6 messages from 2016-05-29 to 2016-06-16. Participants: Dave Nicolson, Junio C Hamano, David Nicolson. Thread: https://gitlist.dev/t/42479 ## Dave Nicolson, 2016-05-29 17:44 Subject: [PATCH] Documentation: GPG capitalization Message-ID: <01020154fd9dec3d-61772857-8b92-4505-ac0f-5058d490f7dc-000000@eu-west-1.amazonses.com> URL: https://gitlist.dev/e/01020154fd9dec3d-61772857-8b92-4505-ac0f-5058d490f7dc-000000%40eu-west-1.amazonses.com ``` When "GPG" is used in a sentence it is now consistently capitalized. When referring to the binary it is left as "gpg". Signed-off-by: David Nicolson --- Documentation/git-mktag.txt | 2 +- Documentation/git-tag.txt | 2 +- Documentation/git-verify-commit.txt | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/git-mktag.txt b/Documentation/git-mktag.txt index fa6a756..724408d 100644 --- a/Documentation/git-mktag.txt +++ b/Documentation/git-mktag.txt @@ -32,7 +32,7 @@ followed by some 'optional' free-form message (some tags created by older Git may not have `tagger` line). The message, when exists, is separated by a blank line from the header. The message part may contain a signature that Git itself doesn't -care about, but that can be verified with gpg. +care about, but that can be verified with GPG. GIT --- diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt index abab481..32bc4aa 100644 --- a/Documentation/git-tag.txt +++ b/Documentation/git-tag.txt @@ -78,7 +78,7 @@ OPTIONS -v:: --verify:: - Verify the gpg signature of the given tag names. + Verify the GPG signature of the given tag names. -n:: specifies how many lines from the annotation, if any, diff --git a/Documentation/git-verify-commit.txt b/Documentation/git-verify-commit.txt index ecf4da1..0101f0f 100644 --- a/Documentation/git-verify-commit.txt +++ b/Documentation/git-verify-commit.txt @@ -12,12 +12,12 @@ SYNOPSIS DESCRIPTION ----------- -Validates the gpg signature created by 'git commit -S'. +Validates the GPG signature created by 'git commit -S'. OPTIONS ------- --raw:: - Print the raw gpg status output to standard error instead of the normal + Print the raw GPG status output to standard error instead of the normal human-readable output. -v:: -- https://github.com/git/git/pull/246 ``` ## Junio C Hamano, 2016-05-30 18:02 Subject: Re: [PATCH] Documentation: GPG capitalization Message-ID: URL: https://gitlist.dev/e/xmqqvb1vo25i.fsf%40gitster.mtv.corp.google.com In-Reply-To: <01020154fd9dec3d-61772857-8b92-4505-ac0f-5058d490f7dc-000000@eu-west-1.amazonses.com> ``` Dave Nicolson writes: > When "GPG" is used in a sentence it is now consistently capitalized. When referring to the binary it is left as "gpg". > > Signed-off-by: David Nicolson > --- > Documentation/git-mktag.txt | 2 +- > Documentation/git-tag.txt | 2 +- > Documentation/git-verify-commit.txt | 4 ++-- > 3 files changed, 4 insertions(+), 4 deletions(-) > > diff --git a/Documentation/git-mktag.txt b/Documentation/git-mktag.txt > index fa6a756..724408d 100644 > --- a/Documentation/git-mktag.txt > +++ b/Documentation/git-mktag.txt > @@ -32,7 +32,7 @@ followed by some 'optional' free-form message (some tags created > by older Git may not have `tagger` line). The message, when > exists, is separated by a blank line from the header. The > message part may contain a signature that Git itself doesn't > -care about, but that can be verified with gpg. > +care about, but that can be verified with GPG. Isn't this a name of the program, though? Other two hunks in your patch clearly refer to the concept and not to a particular program, and they are good changes, I think. > > GIT > --- > diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt > index abab481..32bc4aa 100644 > --- a/Documentation/git-tag.txt > +++ b/Documentation/git-tag.txt > @@ -78,7 +78,7 @@ OPTIONS > > -v:: > --verify:: > - Verify the gpg signature of the given tag names. > + Verify the GPG signature of the given tag names. > > -n:: > specifies how many lines from the annotation, if any, > diff --git a/Documentation/git-verify-commit.txt b/Documentation/git-verify-commit.txt > index ecf4da1..0101f0f 100644 > --- a/Documentation/git-verify-commit.txt > +++ b/Documentation/git-verify-commit.txt > @@ -12,12 +12,12 @@ SYNOPSIS > > DESCRIPTION > ----------- > -Validates the gpg signature created by 'git commit -S'. > +Validates the GPG signature created by 'git commit -S'. > > OPTIONS > ------- > --raw:: > - Print the raw gpg status output to standard error instead of the normal > + Print the raw GPG status output to standard error instead of the normal > human-readable output. > > -v:: > > -- > https://github.com/git/git/pull/246 ``` ## David Nicolson, 2016-05-30 21:43 Subject: Re: [PATCH] Documentation: GPG capitalization Message-ID: URL: https://gitlist.dev/e/CAKp3HaMvsJ58fvtC%2Brp13wigw75vVm3F7T2U%2BGqnyqke71279Q%40mail.gmail.com In-Reply-To: ``` On Mon, May 30, 2016 at 8:02 PM, Junio C Hamano wrote: > Dave Nicolson writes: > >> When "GPG" is used in a sentence it is now consistently capitalized. When referring to the binary it is left as "gpg". >> >> Signed-off-by: David Nicolson >> --- >> Documentation/git-mktag.txt | 2 +- >> Documentation/git-tag.txt | 2 +- >> Documentation/git-verify-commit.txt | 4 ++-- >> 3 files changed, 4 insertions(+), 4 deletions(-) >> >> diff --git a/Documentation/git-mktag.txt b/Documentation/git-mktag.txt >> index fa6a756..724408d 100644 >> --- a/Documentation/git-mktag.txt >> +++ b/Documentation/git-mktag.txt >> @@ -32,7 +32,7 @@ followed by some 'optional' free-form message (some tags created >> by older Git may not have `tagger` line). The message, when >> exists, is separated by a blank line from the header. The >> message part may contain a signature that Git itself doesn't >> -care about, but that can be verified with gpg. >> +care about, but that can be verified with GPG. > > Isn't this a name of the program, though? Other two hunks in your > patch clearly refer to the concept and not to a particular program, > and they are good changes, I think. This one was not as clear as the other hunks. Git is referred to as "Git" in the preceding line, which in itself could be referring to the concept or the particular program I guess? ``` ## Junio C Hamano, 2016-05-30 22:07 Subject: Re: [PATCH] Documentation: GPG capitalization Message-ID: URL: https://gitlist.dev/e/xmqq4m9f8ajq.fsf%40gitster.mtv.corp.google.com In-Reply-To: ``` David Nicolson writes: >>> message part may contain a signature that Git itself doesn't >>> -care about, but that can be verified with gpg. >>> +care about, but that can be verified with GPG. >> >> Isn't this a name of the program, though? Other two hunks in your >> patch clearly refer to the concept and not to a particular program, >> and they are good changes, I think. > > This one was not as clear as the other hunks. Git is referred to as > "Git" in the preceding line, which in itself could be referring to the > concept or the particular program I guess? I think the "Git" you see above is clearly the "stupid content tracker Git", not a particular implementation. It is more about the data model of Git than our particular implementation of it. jgit, a Java implementation of Git, does not care about the gibberish in the "--BEGIN PGP..." block the same way we don't care. ``` ## Dave Nicolson, 2016-06-16 22:15 Subject: [PATCH v2] Documentation: GPG capitalization Message-ID: <010201555b48c824-324d848d-838a-4908-bf88-bc2ee290da76-000000@eu-west-1.amazonses.com> URL: https://gitlist.dev/e/010201555b48c824-324d848d-838a-4908-bf88-bc2ee290da76-000000%40eu-west-1.amazonses.com In-Reply-To: <01020154fd9dec3d-61772857-8b92-4505-ac0f-5058d490f7dc-000000@eu-west-1.amazonses.com> ``` When "GPG" is used in a sentence it is now consistently capitalized. When referring to the binary it is left as "gpg". Signed-off-by: David Nicolson --- Documentation/git-tag.txt | 2 +- Documentation/git-verify-commit.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt index abab481..32bc4aa 100644 --- a/Documentation/git-tag.txt +++ b/Documentation/git-tag.txt @@ -78,7 +78,7 @@ OPTIONS -v:: --verify:: - Verify the gpg signature of the given tag names. + Verify the GPG signature of the given tag names. -n:: specifies how many lines from the annotation, if any, diff --git a/Documentation/git-verify-commit.txt b/Documentation/git-verify-commit.txt index ecf4da1..92097f6 100644 --- a/Documentation/git-verify-commit.txt +++ b/Documentation/git-verify-commit.txt @@ -12,7 +12,7 @@ SYNOPSIS DESCRIPTION ----------- -Validates the gpg signature created by 'git commit -S'. +Validates the GPG signature created by 'git commit -S'. OPTIONS ------- -- https://github.com/git/git/pull/246 ``` ## Junio C Hamano, 2016-06-16 23:31 Subject: Re: [PATCH v2] Documentation: GPG capitalization Message-ID: URL: https://gitlist.dev/e/xmqqtwgs3e42.fsf%40gitster.mtv.corp.google.com In-Reply-To: <010201555b48c824-324d848d-838a-4908-bf88-bc2ee290da76-000000@eu-west-1.amazonses.com> ``` Thanks. ```