# howto-index not found
6 messages from 2021-02-04 to 2021-02-04. Participants: Bulgrien, Dennis, Eric Sunshine, Jeff King.
Thread: https://gitlist.dev/t/55108
## Bulgrien, Dennis, 2021-02-04 19:16
Subject: howto-index not found
Message-ID: <68e6a4e1991d4066a39b84ab5924202a@astronics.com>
URL: https://gitlist.dev/e/68e6a4e1991d4066a39b84ab5924202a%40astronics.com
```
The https://git-scm.com/docs/gittutorial-2 says 'For some interesting examples of Git use, see the howtos"' but that does not exist and redirects to https://git-scm.com/docs. Where should that link be updates it point?
I found https://git-scm.com/docs/gitworkflows which looks somewhat fitting or perhaps https://github.com/git/git/tree/master/Documentation/howto.
Dennis
This E-mail is confidential. It may also be legally privileged. If you are not the addressee you may not copy, forward, disclose or use any part of it. If you have received this message in error, please delete it and all copies from your system and notify the sender immediately by return E-mail.
Internet communications cannot be guaranteed to be timely, secure, error or virus-free. The sender does not accept liability for any errors or omissions.
PLEASE NOTE that Freedom Communication Technologies is now a part of Astronics Test Systems (ATS) and email addresses are changing. Please update my contact info by replacing @freedomcte.com with @astronics.com to direct your messages to my new email address (for example, first.last@freedomcte.com will be updated to first.last@astronics.com)
```
## Eric Sunshine, 2021-02-04 19:58
Subject: Re: howto-index not found
Message-ID:
URL: https://gitlist.dev/e/CAPig%2BcT3qrYB09Z5J5afJUOUU6HvCm6jgjsMNQ_8nqHQUK70Og%40mail.gmail.com
In-Reply-To: <68e6a4e1991d4066a39b84ab5924202a@astronics.com>
```
On Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis
wrote:
> The https://git-scm.com/docs/gittutorial-2 says 'For some interesting examples of Git use, see the howtos"' 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
```
## Bulgrien, Dennis, 2021-02-04 20:32
Subject: RE: howto-index not found
Message-ID: <4c28b85df67b4e9198561e73d8f4d6c9@astronics.com>
URL: https://gitlist.dev/e/4c28b85df67b4e9198561e73d8f4d6c9%40astronics.com
In-Reply-To:
```
Eric,
I was going to report it on github but it[1] says "Make sure this is NOT an issue about : - the Git documentation (a.k.a. man/help pages, i.e. anything with a URL starting with https://git-scm.com/docs), which should be raised with the community at https://git-scm.com/community,..."
[1]: https://github.com/git/git-scm.com/issues/new
Dennis
-----Original Message-----
From: Eric Sunshine
Sent: Thursday, February 4, 2021 1:59 PM
To: Bulgrien, Dennis
Cc: git@vger.kernel.org
Subject: Re: howto-index not found
On Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis wrote:
> The https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgit-scm.com%2Fdocs%2Fgittutorial-2&data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C4480515b1d654da4745e08d8c94749e0%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480655312867779%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&sdata=cDMLo0Xg04V%2FtBa9s7LoGSJvyHMLb6pdKdwxymvZCfA%3D&reserved=0 says 'For some interesting examples of Git use, see the howtos"' but that does not exist and redirects to https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgit-scm.com%2Fdocs&data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C4480515b1d654da4745e08d8c94749e0%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480655312877735%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&sdata=X8EOQhtqBejIfSo0nSDm4iGXuWVXay7c3XaxKTKo5pI%3D&reserved=0. 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://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fgit%2Fgit-scm.com&data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C4480515b1d654da4745e08d8c94749e0%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480655312877735%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&sdata=dQ9HE8EruC2UN5mDtWVrV5eSRj9gG7K8IDb%2BZ%2FrTe7o%3D&reserved=0
[2]: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fgit%2Fgit-scm.com%2Fissues&data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C4480515b1d654da4745e08d8c94749e0%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480655312877735%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&sdata=VG8y3gsYIEo1wsEIj%2BulX%2F6R3dacVpn%2Bzy4cnJ4ChR8%3D&reserved=0
This E-mail is confidential. It may also be legally privileged. If you are not the addressee you may not copy, forward, disclose or use any part of it. If you have received this message in error, please delete it and all copies from your system and notify the sender immediately by return E-mail.
Internet communications cannot be guaranteed to be timely, secure, error or virus-free. The sender does not accept liability for any errors or omissions.
PLEASE NOTE that Freedom Communication Technologies is now a part of Astronics Test Systems (ATS) and email addresses are changing. Please update my contact info by replacing @freedomcte.com with @astronics.com to direct your messages to my new email address (for example, first.last@freedomcte.com will be updated to first.last@astronics.com)
```
## Bulgrien, Dennis, 2021-02-04 20:34
Subject: RE: howto-index not found
Message-ID:
URL: https://gitlist.dev/e/bda4965e57c74f2a8f855ab7d92e71ca%40astronics.com
In-Reply-To:
```
The github tracker redirects back to this group, saying "These pages are generated from git man pages, so we have no control over it. Have you reported it to the community at https://git-scm.com/community ?"
[1]: https://github.com/git/git-scm.com/issues/1521
Dennis
-----Original Message-----
From: Jeff King
Sent: Thursday, February 4, 2021 2:27 PM
To: Eric Sunshine
Cc: Bulgrien, Dennis ; git@vger.kernel.org
Subject: Re: howto-index not found
On Thu, Feb 04, 2021 at 02:58:36PM -0500, Eric Sunshine wrote:
> On Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis
> wrote:
> > The https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgit-scm.com%2Fdocs%2Fgittutorial-2&data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C35dd885da77a4dcd278c08d8c94b440e%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480672478665490%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&sdata=r4A4aBuyi8gsu0gveUsQTEcIwsWjFM8VkzqJl0AKuhE%3D&reserved=0 says 'For some interesting examples of Git use, see the howtos"' but that does not exist and redirects to https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgit-scm.com%2Fdocs&data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C35dd885da77a4dcd278c08d8c94b440e%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480672478665490%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&sdata=QOqO1zrsjxNSt%2BeIkK8i78CTEJbGkX3L%2Fx4V9Bc04UQ%3D&reserved=0. 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://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgith
> ub.com%2Fgit%2Fgit-scm.com&data=04%7C01%7CDennis.Bulgrien%40astron
> ics.com%7C35dd885da77a4dcd278c08d8c94b440e%7Ca2ce8a60084049b7938997ad8
> 11e2924%7C1%7C0%7C637480672478675488%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiM
> C4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&s
> data=9i3oILcm954P6K2UGUNgKsdIjL54XjdkfPJYVWeo7os%3D&reserved=0
> [2]:
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgith
> ub.com%2Fgit%2Fgit-scm.com%2Fissues&data=04%7C01%7CDennis.Bulgrien
> %40astronics.com%7C35dd885da77a4dcd278c08d8c94b440e%7Ca2ce8a60084049b7
> 938997ad811e2924%7C1%7C0%7C637480672478675488%7CUnknown%7CTWFpbGZsb3d8
> eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2
> 000&sdata=n%2FpniKdjdmuzASUIdGn1%2BfcJnkTul1EdGnwt2SvKMkg%3D&r
> eserved=0
There's already an issue here:
https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fgit%2Fgit-scm.com%2Fissues%2F1521&data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C35dd885da77a4dcd278c08d8c94b440e%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480672478675488%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&sdata=YnvAqClHZb3Ne5RtIpSQO%2BZI6IbgmWrqRjZhYaaUjys%3D&reserved=0
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
This E-mail is confidential. It may also be legally privileged. If you are not the addressee you may not copy, forward, disclose or use any part of it. If you have received this message in error, please delete it and all copies from your system and notify the sender immediately by return E-mail.
Internet communications cannot be guaranteed to be timely, secure, error or virus-free. The sender does not accept liability for any errors or omissions.
PLEASE NOTE that Freedom Communication Technologies is now a part of Astronics Test Systems (ATS) and email addresses are changing. Please update my contact info by replacing @freedomcte.com with @astronics.com to direct your messages to my new email address (for example, first.last@freedomcte.com will be updated to first.last@astronics.com)
```
## Jeff King, 2021-02-04 20:27
Subject: Re: howto-index not found
Message-ID:
URL: https://gitlist.dev/e/YBxYowmCO50QmhVp%40coredump.intra.peff.net
In-Reply-To:
```
On Thu, Feb 04, 2021 at 02:58:36PM -0500, Eric Sunshine wrote:
> On Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis
> wrote:
> > The https://git-scm.com/docs/gittutorial-2 says 'For some interesting examples of Git use, see the howtos"' 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
```
## Jeff King, 2021-02-04 21:09
Subject: Re: howto-index not found
Message-ID:
URL: https://gitlist.dev/e/YBxim%2FCGZAzttpoN%40coredump.intra.peff.net
In-Reply-To:
```
On Thu, Feb 04, 2021 at 08:34:18PM +0000, Bulgrien, Dennis wrote:
> The github tracker redirects back to this group, saying "These pages
> are generated from git man pages, so we have no control over it. Have
> you reported it to the community at https://git-scm.com/community ?"
>
> [1]: https://github.com/git/git-scm.com/issues/1521
Yeah, there are sort of two questions here:
- should git-scm.com be generating the howto-index, api-index, etc;
that's an issue that would be solved there (because it has custom
code to import and format the documentation from git.git).
- should Documentation/git.txt be more careful about referencing
potentially-absent html files from the manpage builds. That's an
issue that should be solved here on the mailing list.
-Peff
```