Re: [PATCH v2 2/5] doc: git-diff: apply format changes to diff-options
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Nov 12, 2024, 00:52 UTC
- Message-ID
- <xmqqh68d8e9h.fsf@gitster.g>
- In-Reply-To
- <129763c2aaefd92bddaa59601c5a3275b9defa36.1731343985.git.gitgitgadget@gmail.com>
"Jean-Noël Avila via GitGitGadget" <gitgitgadget@gmail.com> writes:
> --s:: > ---no-patch:: > +`-s`:: > +`--no-patch`::
These are understandable. These dashed options that are to be given literally are shown as `literal`.
> @@ -39,28 +39,28 @@ endif::git-format-patch[] > ifdef::git-log[] > -m::
Shouldn't this and all others like -c/--cc be also quoted as `literal` options?
> @@ -73,33 +73,33 @@ The following formats are supported: > off, none::
Shouldn't this and other option values like on, first-parent, etc., that are literals be marked-up specially?
Show 6 quoted lines
> --U<n>:: > ---unified=<n>:: > - Generate diffs with <n> lines of context instead of > +`-U<n>`:: > +`--unified=<n>`:: > + Generate diffs with _<n>_ lines of context instead of
Understandable. Shouldn't <n> part be italicised?
> ---output=<file>:: > +`--output=<file>`::
Likewise.
Thanks.