{"thread":{"id":"65665","subject":"[PATCH] Documentation/git-range-diff: add missing notes options in synopsis","startedAt":"2026-05-21T04:19:32Z","lastAt":"2026-05-21T05:28:56Z","messageCount":3,"participants":["Siddh Raman Pant","Kristoffer Haugsbakk"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"543767","messageId":"20260521041908.41055-1-siddh.raman.pant@oracle.com","threadId":"65665","inReplyTo":null,"subject":"[PATCH] Documentation/git-range-diff: add missing notes options in synopsis","fromName":"Siddh Raman Pant","fromEmail":"siddh.raman.pant@oracle.com","sentAt":"2026-05-21T04:19:08Z","receivedAt":"2026-05-21T04:19:32Z","isPatch":true,"body":"git-range-diff supports note options which are also mentioned later in\nthe help, but they are missing from synopis. Let's fix that.\n\nFixes: bd3619188682 (\"range-diff: pass through --notes to `git log`\")\nSigned-off-by: Siddh Raman Pant <siddh.raman.pant@oracle.com>\n---\n Documentation/git-range-diff.adoc | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-range-diff.adoc b/Documentation/git-range-diff.adoc\nindex 880557084533..5cc5e2ed5673 100644\n--- a/Documentation/git-range-diff.adoc\n+++ b/Documentation/git-range-diff.adoc\n@@ -11,7 +11,7 @@ SYNOPSIS\n git range-diff [--color=[<when>]] [--no-color] [<diff-options>]\n \t[--no-dual-color] [--creation-factor=<factor>]\n \t[--left-only | --right-only] [--diff-merges=<format>]\n-\t[--remerge-diff]\n+\t[--remerge-diff] [--no-notes | --notes[=<ref>]]\n \t( <range1> <range2> | <rev1>...<rev2> | <base> <rev1> <rev2> )\n \t[[--] <path>...]\n \n-- \n2.53.0\n\n"},{"id":"543770","messageId":"72839071-153f-4306-a705-3be0dc203109@app.fastmail.com","threadId":"65665","inReplyTo":"20260521041908.41055-1-siddh.raman.pant@oracle.com","subject":"Re: [PATCH] Documentation/git-range-diff: add missing notes options in synopsis","fromName":"Kristoffer Haugsbakk","fromEmail":"kristofferhaugsbakk@fastmail.com","sentAt":"2026-05-21T05:12:27Z","receivedAt":"2026-05-21T05:12:48Z","isPatch":true,"body":"On Thu, May 21, 2026, at 06:19, Siddh Raman Pant wrote:\n> git-range-diff supports note options which are also mentioned later in\n> the help, but they are missing from synopis. Let's fix that.\n\ns/synopis/synopsis/ or s/synopis/the synopsis/\n\n>\n> Fixes: bd3619188682 (\"range-diff: pass through --notes to `git log`\")\n\nThis project doesn’t use `Fixes` trailers. Mentions of commits go in the\ncommit message body (outside the trailers) using `git log -1\n--format-reference <cmt>`.\n\nThe Linux project has uses for this structured information since there\nis a lot of backporting of bugfixes. But I haven’t heard of a need for\nthat in this project.\n\n> Signed-off-by: Siddh Raman Pant <siddh.raman.pant@oracle.com>\n> ---\n>  Documentation/git-range-diff.adoc | 2 +-\n>  1 file changed, 1 insertion(+), 1 deletion(-)\n\nOkay, there is no need to update the synopsis in the source code since\ngit-range-diff(1) is excluded from `t/t0450-txt-doc-vs-help.sh`. So this\nlooks correct.\n\n>\n> diff --git a/Documentation/git-range-diff.adoc\n>[snip]\n"},{"id":"543771","messageId":"20260521052841.73775-1-siddh.raman.pant@oracle.com","threadId":"65665","inReplyTo":"72839071-153f-4306-a705-3be0dc203109@app.fastmail.com","subject":"[PATCH v2] Documentation/git-range-diff: add missing notes options in synopsis","fromName":"Siddh Raman Pant","fromEmail":"siddh.raman.pant@oracle.com","sentAt":"2026-05-21T05:28:41Z","receivedAt":"2026-05-21T05:28:56Z","isPatch":true,"body":"git-range-diff supports note options which are also mentioned later in\nthe help, but they are missing from the synopsis. Let's fix that.\n\nSigned-off-by: Siddh Raman Pant <siddh.raman.pant@oracle.com>\n---\nv1 -> v2: Fixed typo and removed fixes line.\n\n Documentation/git-range-diff.adoc | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-range-diff.adoc b/Documentation/git-range-diff.adoc\nindex 880557084533..5cc5e2ed5673 100644\n--- a/Documentation/git-range-diff.adoc\n+++ b/Documentation/git-range-diff.adoc\n@@ -11,7 +11,7 @@ SYNOPSIS\n git range-diff [--color=[<when>]] [--no-color] [<diff-options>]\n \t[--no-dual-color] [--creation-factor=<factor>]\n \t[--left-only | --right-only] [--diff-merges=<format>]\n-\t[--remerge-diff]\n+\t[--remerge-diff] [--no-notes | --notes[=<ref>]]\n \t( <range1> <range2> | <rev1>...<rev2> | <base> <rev1> <rev2> )\n \t[[--] <path>...]\n \n-- \n2.53.0\n\n"}]}