Re: [PATCH 2/7] git-bugreport.txt: fix reference to strftime(3)

From: Martin Ågren <martin.agren@gmail.com>
Date: May 18, 2020, 11:15 UTC
Message-ID: <CAN0heSpu7yjB0aJRuRhU+dncDryTRkMq4+B_D4BHBav5YoD1gw@mail.gmail.com>
In-Reply-To: <96735cc6-35d6-f94d-75d5-d6d4df1aefa0@gmail.com>

On Mon, 18 May 2020 at 12:54, Jean-Noël Avila <avila.jn@gmail.com> wrote:

Show 8 quoted lines

>
> On Mon, 18 May 2020, Martin Ågren, Eric Sunshine wrote:
> > On Sun, 17 May 2020 at 21:23, Eric Sunshine <sunshine@sunshineco.com> wrote:
> >> On Sun, May 17, 2020 at 2:52 PM Martin Ågren <martin.agren@gmail.com> wrote:
> >>> When we say "link:strftime[3]", it ends up rendered as "3[1]" and we
> >>> produce a footnote referring to the non-existing
> >>> file:///.../git-doc/strftime. Make sure we use gitlink, not link, to get
> >> s/gitlink/linkgit/

Show 5 quoted lines

> > Oops, thanks! At least the diff is correct.
>
> Not even sure of that: strftime is not an internal manpage, so for html
> target, we will end up with a hyperlink to an non-existing file
> strftime.html. So I would keep it as simple text.

That's a good point. I don't use the HTML versions myself, so I haven't thought about the *linking* nature much -- I just see the formatting. But you're right. Grepping around, we only seem to use linkgit to refer to our own docs. So this should probably just be "strftime(3)" as you say.

Thanks, Martin