{"thread":{"id":"65559","subject":"[PATCH 0/2] doc: log: fix --decorate description list","startedAt":"2026-04-27T19:07:06Z","lastAt":"2026-05-12T06:03:14Z","messageCount":4,"participants":["kristofferhaugsbakk@fastmail.com","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":2},"messages":[{"id":"542394","messageId":"CV_doc_log_--decorate_list.626@msgid.xyz","threadId":"65559","inReplyTo":null,"subject":"[PATCH 0/2] doc: log: fix --decorate description list","fromName":"","fromEmail":"kristofferhaugsbakk@fastmail.com","sentAt":"2026-04-27T19:06:48Z","receivedAt":"2026-04-27T19:07:06Z","isPatch":true,"body":"From: Kristoffer Haugsbakk <code@khaugsbakk.name>\n\nTopic name: kh/doc-log-decorate-list\n\nTopic summary: Fix formatting of the '--decorate' description list.\n\n[1/2] doc: log: fix --decorate description list\n[2/2] doc: log: use the same delimiter in description list\n\n Documentation/git-log.adoc | 6 +++---\n 1 file changed, 3 insertions(+), 3 deletions(-)\n\n\nbase-commit: 67ad42147a7acc2af6074753ebd03d904476118f\n-- \n2.54.0.13.g9c7419e39f8\n\n"},{"id":"542395","messageId":"source_block_description_list.627@msgid.xyz","threadId":"65559","inReplyTo":"CV_doc_log_--decorate_list.626@msgid.xyz","subject":"[PATCH 1/2] doc: log: fix --decorate description list","fromName":"","fromEmail":"kristofferhaugsbakk@fastmail.com","sentAt":"2026-04-27T19:06:49Z","receivedAt":"2026-04-27T19:07:24Z","isPatch":true,"body":"From: Kristoffer Haugsbakk <code@khaugsbakk.name>\n\n026f2e3b (doc: convert git-log to new documentation format, 2025-07-07)\ntransformed the inline description of `--decorate` options to a\ndescription list:\n\n    We also transform inline descriptions of possible values of option\n    --decorate into a list, which is more readable and extensible.\n\nBut a source code block was used instead of an open block.\n\nSigned-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>\n---\n Documentation/git-log.adoc | 4 ++--\n 1 file changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/git-log.adoc b/Documentation/git-log.adoc\nindex e304739c5e8..1c95499060d 100644\n--- a/Documentation/git-log.adoc\n+++ b/Documentation/git-log.adoc\n@@ -36,14 +36,14 @@ OPTIONS\n \tPrint out the ref names of any commits that are shown. Possible values\n \tare:\n +\n-----\n+--\n `short`;; the ref name prefixes `refs/heads/`, `refs/tags/` and\n \t`refs/remotes/` are not printed.\n `full`;; the full ref name (including prefix) is printed.\n `auto`:: if the output is going to a terminal, the ref names\n \tare shown as if `short` were given, otherwise no ref names are\n \tshown.\n-----\n+--\n +\n The option `--decorate` is short-hand for `--decorate=short`. Default to\n configuration value of `log.decorate` if configured, otherwise, `auto`.\n-- \n2.54.0.13.g9c7419e39f8\n\n"},{"id":"542396","messageId":"do_not_nest_description_list.628@msgid.xyz","threadId":"65559","inReplyTo":"CV_doc_log_--decorate_list.626@msgid.xyz","subject":"[PATCH 2/2] doc: log: use the same delimiter in description list","fromName":"","fromEmail":"kristofferhaugsbakk@fastmail.com","sentAt":"2026-04-27T19:06:50Z","receivedAt":"2026-04-27T19:07:42Z","isPatch":true,"body":"From: Kristoffer Haugsbakk <code@khaugsbakk.name>\n\nWe must use the same delimiter since this is a meant to be a flat\nlist. Introducing a new legal delimiter like `::` makes an inner\ndescription list:\n\n    ...\n    full\n    the full ref name ...\n\n        auto\n        if the output ...\n\nSigned-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>\n---\n Documentation/git-log.adoc | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-log.adoc b/Documentation/git-log.adoc\nindex 1c95499060d..fb3ac112839 100644\n--- a/Documentation/git-log.adoc\n+++ b/Documentation/git-log.adoc\n@@ -40,7 +40,7 @@ OPTIONS\n `short`;; the ref name prefixes `refs/heads/`, `refs/tags/` and\n \t`refs/remotes/` are not printed.\n `full`;; the full ref name (including prefix) is printed.\n-`auto`:: if the output is going to a terminal, the ref names\n+`auto`;; if the output is going to a terminal, the ref names\n \tare shown as if `short` were given, otherwise no ref names are\n \tshown.\n --\n-- \n2.54.0.13.g9c7419e39f8\n\n"},{"id":"543139","messageId":"xmqqpl31np0l.fsf@gitster.g","threadId":"65559","inReplyTo":"CV_doc_log_--decorate_list.626@msgid.xyz","subject":"Re: [PATCH 0/2] doc: log: fix --decorate description list","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2026-05-12T06:03:06Z","receivedAt":"2026-05-12T06:03:14Z","isPatch":true,"body":"kristofferhaugsbakk@fastmail.com writes:\n\n> From: Kristoffer Haugsbakk <code@khaugsbakk.name>\n>\n> Topic name: kh/doc-log-decorate-list\n>\n> Topic summary: Fix formatting of the '--decorate' description list.\n>\n> [1/2] doc: log: fix --decorate description list\n> [2/2] doc: log: use the same delimiter in description list\n>\n>  Documentation/git-log.adoc | 6 +++---\n>  1 file changed, 3 insertions(+), 3 deletions(-)\n>\n>\n> base-commit: 67ad42147a7acc2af6074753ebd03d904476118f\n\nThis does give us a solid improvement.  Let me mark the topic for\n'next'.\n\nThanks.\n"}]}