git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 1/1] doc/diff-options: fix link to generating patch section

From
Sergey Organov <sorganov@gmail.com>
Date
Sep 6, 2023, 06:47 UTC
Message-ID
<87tts7pzl2.fsf@osv.gnss.ru>
In-Reply-To
<xmqq34zsqlr3.fsf@gitster.g>
Junio C Hamano <gitster@pobox.com> writes:
Show 17 quoted lines
> Sergey Organov <sorganov@gmail.com> writes:
>
>> First, there is no need for conditional referencing, as all the files
>> that include "diff-options.txt" eventually include
>> "diff-generate-patch.txt" as well.
>
> Except for git-format-patch.txt which includes the former but not
> the latter.  But this is inside ifndef::git-format-patch[], so the
> above description being a bit imprecise does not cause any actual
> damage.
>
>     Documentation for all commands that want to describe the `-p`
>     option by including the "diff-options.txt" file also include the
>     "diff-generate-patch.txt" file, so an internal link would work
>     for all of them.
>
> or something like that, perhaps.

In fact I just realized that removing conditionals in fact *fixes* those documents by providing proper link in them as well, so I'll think of better description taking into account your observation as well, and then will re-roll.

Thanks, -- Sergey Organov

Previous: Sergey OrganovNext: Junio C Hamano
Message 4 of 6 in “doc/diff-options: fix link to generating patch section”
  1. 1/1 doc/diff-options: fix link to generating patch sectionSergey Organov, Sep 5, 2023
  2. Junio C HamanoSep 5, 2023
  3. Sergey OrganovSep 6, 2023
  4. Sergey OrganovSep 6, 2023
  5. Junio C HamanoSep 6, 2023
  6. 1/1 doc/diff-options: fix link to generating patch sectionSergey Organov, Sep 6, 2023

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.