Re: howto-index not found

From: Jeff King <peff@peff.net>
Date: Feb 4, 2021, 20:27 UTC
Message-ID: <YBxYowmCO50QmhVp@coredump.intra.peff.net>
In-Reply-To: <CAPig+cT3qrYB09Z5J5afJUOUU6HvCm6jgjsMNQ_8nqHQUK70Og@mail.gmail.com>

On Thu, Feb 04, 2021 at 02:58:36PM -0500, Eric Sunshine wrote:

Show 11 quoted lines

> On Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis
> <Dennis.Bulgrien@astronics.com> wrote:
> > The https://git-scm.com/docs/gittutorial-2 says 'For some interesting examples of Git use, see the <a href="http://git-scm.com/docs/howto-index">howtos</a>"' but that does not exist and redirects to https://git-scm.com/docs. Where should that link be updates it point?
> 
> `howtos-index` does get generated by the Git project but doesn't
> appear to be published on the git-scm site for some reason. git-scm is
> maintained as a separate project[1], so the best thing to do is to
> report the problem there using their bug tracker[2].
> 
> [1]: https://github.com/git/git-scm.com
> [2]: https://github.com/git/git-scm.com/issues

There's already an issue here:

  https://github.com/git/git-scm.com/issues/1521

But I think there's a larger problem within Git's manpages themselves. There is no manpage version of many of the pages, yet git.txt still links to them. So "man git" on my system points to to several file:// urls that doesn't exist. This is true of my custom-built Git, but I think also true for some system package setups (e.g., Debian's "git" package ships the manpages, but you don't get the html versions unless you install "git-doc" as well).

-Peff