From: Martin Ågren <martin.agren@gmail.com>
Date: Mon, 18 May 2020 11:15:49 GMT
Subject: Re: [PATCH 2/7] git-bugreport.txt: fix reference to strftime(3)
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:
>
> 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/

> > 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