{"thread":{"id":"64602","subject":"[PATCH] doc: fix `update-ref` `symref-create` formatting","startedAt":"2025-12-09T06:23:42Z","lastAt":"2025-12-09T22:18:32Z","messageCount":3,"participants":["Sam Bostock via GitGitGadget","Patrick Steinhardt","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"531886","messageId":"pull.2123.git.git.1765261419802.gitgitgadget@gmail.com","threadId":"64602","inReplyTo":null,"subject":"[PATCH] doc: fix `update-ref` `symref-create` formatting","fromName":"Sam Bostock via GitGitGadget","fromEmail":"gitgitgadget@gmail.com","sentAt":"2025-12-09T06:23:39Z","receivedAt":"2025-12-09T06:23:42Z","isPatch":true,"sender":{"key":"sam.bostock@shopify.com","avatar":"https://avatars.githubusercontent.com/u/8219340?v=4"},"body":"From: Sam Bostock <sam@sambostock.ca>\n\n`symref-create` should be followed `::`, not `:`. The lack of second\ncolon (`:`) causes it to appear as regular text (`<p>`) instead of as a\ndescription list term (`<dt>`) in the HTML documentation.\n\nSigned-off-by: Sam Bostock <sam@sambostock.ca>\n---\n    doc: fix update-ref symref-create formatting\n\nPublished-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-2123%2Fsambostock%2Fpatch-1-v1\nFetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-2123/sambostock/patch-1-v1\nPull-Request: https://github.com/git/git/pull/2123\n\n Documentation/git-update-ref.adoc | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-update-ref.adoc b/Documentation/git-update-ref.adoc\nindex 9310ce9768..37a5019a8b 100644\n--- a/Documentation/git-update-ref.adoc\n+++ b/Documentation/git-update-ref.adoc\n@@ -119,7 +119,7 @@ verify::\n \tVerify <ref> against <old-oid> but do not change it.  If\n \t<old-oid> is zero or missing, the ref must not exist.\n \n-symref-create:\n+symref-create::\n \tCreate symbolic ref <ref> with <new-target> after verifying that\n \tit does not exist.\n \n\nbase-commit: bdc5341ff65278a3cc80b2e8a02a2f02aa1fac06\n-- \ngitgitgadget\n"},{"id":"531890","messageId":"aTfOXDi4Ku0nGVnF@pks.im","threadId":"64602","inReplyTo":"pull.2123.git.git.1765261419802.gitgitgadget@gmail.com","subject":"Re: [PATCH] doc: fix `update-ref` `symref-create` formatting","fromName":"Patrick Steinhardt","fromEmail":"ps@pks.im","sentAt":"2025-12-09T07:23:08Z","receivedAt":"2025-12-09T07:23:14Z","isPatch":true,"sender":{"key":"ps@pks.im","avatar":"https://avatars.githubusercontent.com/u/4056630?v=4"},"body":"On Tue, Dec 09, 2025 at 06:23:39AM +0000, Sam Bostock via GitGitGadget wrote:\n> From: Sam Bostock <sam@sambostock.ca>\n> \n> `symref-create` should be followed `::`, not `:`. The lack of second\n> colon (`:`) causes it to appear as regular text (`<p>`) instead of as a\n> description list term (`<dt>`) in the HTML documentation.\n> \n> Signed-off-by: Sam Bostock <sam@sambostock.ca>\n> ---\n>     doc: fix update-ref symref-create formatting\n> \n> Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-2123%2Fsambostock%2Fpatch-1-v1\n> Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-2123/sambostock/patch-1-v1\n> Pull-Request: https://github.com/git/git/pull/2123\n> \n>  Documentation/git-update-ref.adoc | 2 +-\n>  1 file changed, 1 insertion(+), 1 deletion(-)\n> \n> diff --git a/Documentation/git-update-ref.adoc b/Documentation/git-update-ref.adoc\n> index 9310ce9768..37a5019a8b 100644\n> --- a/Documentation/git-update-ref.adoc\n> +++ b/Documentation/git-update-ref.adoc\n> @@ -119,7 +119,7 @@ verify::\n>  \tVerify <ref> against <old-oid> but do not change it.  If\n>  \t<old-oid> is zero or missing, the ref must not exist.\n>  \n> -symref-create:\n> +symref-create::\n>  \tCreate symbolic ref <ref> with <new-target> after verifying that\n>  \tit does not exist.\n\nThis is an obvious fix indeed. Thanks, this looks good to me!\n\nPatrick\n"},{"id":"531921","messageId":"xmqqbjk7jo3u.fsf@gitster.g","threadId":"64602","inReplyTo":"aTfOXDi4Ku0nGVnF@pks.im","subject":"Re: [PATCH] doc: fix `update-ref` `symref-create` formatting","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2025-12-09T22:18:29Z","receivedAt":"2025-12-09T22:18:32Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Patrick Steinhardt <ps@pks.im> writes:\n\n> On Tue, Dec 09, 2025 at 06:23:39AM +0000, Sam Bostock via GitGitGadget wrote:\n>> From: Sam Bostock <sam@sambostock.ca>\n>> \n>> `symref-create` should be followed `::`, not `:`. The lack of second\n>> colon (`:`) causes it to appear as regular text (`<p>`) instead of as a\n>> description list term (`<dt>`) in the HTML documentation.\n>> \n>> Signed-off-by: Sam Bostock <sam@sambostock.ca>\n>> ---\n>>     doc: fix update-ref symref-create formatting\n>> \n>> Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-2123%2Fsambostock%2Fpatch-1-v1\n>> Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-2123/sambostock/patch-1-v1\n>> Pull-Request: https://github.com/git/git/pull/2123\n>> \n>>  Documentation/git-update-ref.adoc | 2 +-\n>>  1 file changed, 1 insertion(+), 1 deletion(-)\n>> \n>> diff --git a/Documentation/git-update-ref.adoc b/Documentation/git-update-ref.adoc\n>> index 9310ce9768..37a5019a8b 100644\n>> --- a/Documentation/git-update-ref.adoc\n>> +++ b/Documentation/git-update-ref.adoc\n>> @@ -119,7 +119,7 @@ verify::\n>>  \tVerify <ref> against <old-oid> but do not change it.  If\n>>  \t<old-oid> is zero or missing, the ref must not exist.\n>>  \n>> -symref-create:\n>> +symref-create::\n>>  \tCreate symbolic ref <ref> with <new-target> after verifying that\n>>  \tit does not exist.\n>\n> This is an obvious fix indeed. Thanks, this looks good to me!\n>\n> Patrick\n\nThanks, both.  Queued.\n"}]}