{"thread":{"id":"55108","subject":"howto-index not found","startedAt":"2021-02-04T19:17:58Z","lastAt":"2021-02-04T21:10:36Z","messageCount":6,"participants":["Bulgrien, Dennis","Eric Sunshine","Jeff King"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"416178","messageId":"68e6a4e1991d4066a39b84ab5924202a@astronics.com","threadId":"55108","inReplyTo":null,"subject":"howto-index not found","fromName":"Bulgrien, Dennis","fromEmail":"dennis.bulgrien@astronics.com","sentAt":"2021-02-04T19:16:48Z","receivedAt":"2021-02-04T19:17:58Z","isPatch":false,"sender":{"key":"dennis.bulgrien@astronics.com","avatar":null},"body":"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?\n\nI found https://git-scm.com/docs/gitworkflows which looks somewhat fitting or perhaps https://github.com/git/git/tree/master/Documentation/howto.\n\nDennis\n\n\nThis 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.\n\nInternet communications cannot be guaranteed to be timely, secure, error or virus-free. The sender does not accept liability for any errors or omissions.\nPLEASE 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)\n"},{"id":"416182","messageId":"CAPig+cT3qrYB09Z5J5afJUOUU6HvCm6jgjsMNQ_8nqHQUK70Og@mail.gmail.com","threadId":"55108","inReplyTo":"68e6a4e1991d4066a39b84ab5924202a@astronics.com","subject":"Re: howto-index not found","fromName":"Eric Sunshine","fromEmail":"sunshine@sunshineco.com","sentAt":"2021-02-04T19:58:36Z","receivedAt":"2021-02-04T20:03:25Z","isPatch":false,"sender":{"key":"sunshine@sunshineco.com","avatar":"https://avatars.githubusercontent.com/u/163641?v=4"},"body":"On Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis\n wrote:\n> 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?\n\n`howtos-index` does get generated by the Git project but doesn't\nappear to be published on the git-scm site for some reason. git-scm is\nmaintained as a separate project[1], so the best thing to do is to\nreport the problem there using their bug tracker[2].\n\n[1]: https://github.com/git/git-scm.com\n[2]: https://github.com/git/git-scm.com/issues\n"},{"id":"416191","messageId":"4c28b85df67b4e9198561e73d8f4d6c9@astronics.com","threadId":"55108","inReplyTo":"CAPig+cT3qrYB09Z5J5afJUOUU6HvCm6jgjsMNQ_8nqHQUK70Og@mail.gmail.com","subject":"RE: howto-index not found","fromName":"Bulgrien, Dennis","fromEmail":"dennis.bulgrien@astronics.com","sentAt":"2021-02-04T20:32:54Z","receivedAt":"2021-02-04T20:35:11Z","isPatch":false,"sender":{"key":"dennis.bulgrien@astronics.com","avatar":null},"body":"Eric,\n\nI 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,...\"\n\n[1]: https://github.com/git/git-scm.com/issues/new\n\nDennis\n\n-----Original Message-----\nFrom: Eric Sunshine \nSent: Thursday, February 4, 2021 1:59 PM\nTo: Bulgrien, Dennis \nCc: git@vger.kernel.org\nSubject: Re: howto-index not found\n\nOn Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis wrote:\n> 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?\n\n`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].\n\n[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\n[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\n\nThis 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.\n\nInternet communications cannot be guaranteed to be timely, secure, error or virus-free. The sender does not accept liability for any errors or omissions.\nPLEASE 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)\n"},{"id":"416193","messageId":"bda4965e57c74f2a8f855ab7d92e71ca@astronics.com","threadId":"55108","inReplyTo":"YBxYowmCO50QmhVp@coredump.intra.peff.net","subject":"RE: howto-index not found","fromName":"Bulgrien, Dennis","fromEmail":"dennis.bulgrien@astronics.com","sentAt":"2021-02-04T20:34:18Z","receivedAt":"2021-02-04T20:35:54Z","isPatch":false,"sender":{"key":"dennis.bulgrien@astronics.com","avatar":null},"body":"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 ?\"\n\n[1]: https://github.com/git/git-scm.com/issues/1521\n\nDennis\n\n-----Original Message-----\nFrom: Jeff King \nSent: Thursday, February 4, 2021 2:27 PM\nTo: Eric Sunshine \nCc: Bulgrien, Dennis ; git@vger.kernel.org\nSubject: Re: howto-index not found\n\nOn Thu, Feb 04, 2021 at 02:58:36PM -0500, Eric Sunshine wrote:\n\n> On Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis\n> wrote:\n> > 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?\n>\n> `howtos-index` does get generated by the Git project but doesn't\n> appear to be published on the git-scm site for some reason. git-scm is\n> maintained as a separate project[1], so the best thing to do is to\n> report the problem there using their bug tracker[2].\n>\n> [1]:\n> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgith\n> ub.com%2Fgit%2Fgit-scm.com&data=04%7C01%7CDennis.Bulgrien%40astron\n> ics.com%7C35dd885da77a4dcd278c08d8c94b440e%7Ca2ce8a60084049b7938997ad8\n> 11e2924%7C1%7C0%7C637480672478675488%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiM\n> C4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&s\n> data=9i3oILcm954P6K2UGUNgKsdIjL54XjdkfPJYVWeo7os%3D&reserved=0\n> [2]:\n> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgith\n> ub.com%2Fgit%2Fgit-scm.com%2Fissues&data=04%7C01%7CDennis.Bulgrien\n> %40astronics.com%7C35dd885da77a4dcd278c08d8c94b440e%7Ca2ce8a60084049b7\n> 938997ad811e2924%7C1%7C0%7C637480672478675488%7CUnknown%7CTWFpbGZsb3d8\n> eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2\n> 000&sdata=n%2FpniKdjdmuzASUIdGn1%2BfcJnkTul1EdGnwt2SvKMkg%3D&r\n> eserved=0\n\nThere's already an issue here:\n\n 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\n\nBut I think there's a larger problem within Git's manpages themselves.\nThere 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\"\npackage ships the manpages, but you don't get the html versions unless you install \"git-doc\" as well).\n\n-Peff\n\nThis 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.\n\nInternet communications cannot be guaranteed to be timely, secure, error or virus-free. The sender does not accept liability for any errors or omissions.\nPLEASE 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)\n"},{"id":"416194","messageId":"YBxYowmCO50QmhVp@coredump.intra.peff.net","threadId":"55108","inReplyTo":"CAPig+cT3qrYB09Z5J5afJUOUU6HvCm6jgjsMNQ_8nqHQUK70Og@mail.gmail.com","subject":"Re: howto-index not found","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2021-02-04T20:27:15Z","receivedAt":"2021-02-04T20:39:55Z","isPatch":false,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Thu, Feb 04, 2021 at 02:58:36PM -0500, Eric Sunshine wrote:\n\n> On Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis\n> wrote:\n> > 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?\n> \n> `howtos-index` does get generated by the Git project but doesn't\n> appear to be published on the git-scm site for some reason. git-scm is\n> maintained as a separate project[1], so the best thing to do is to\n> report the problem there using their bug tracker[2].\n> \n> [1]: https://github.com/git/git-scm.com\n> [2]: https://github.com/git/git-scm.com/issues\n\nThere's already an issue here:\n\n https://github.com/git/git-scm.com/issues/1521\n\nBut I think there's a larger problem within Git's manpages themselves.\nThere is no manpage version of many of the pages, yet git.txt still\nlinks to them. So \"man git\" on my system points to to several file://\nurls that doesn't exist. This is true of my custom-built Git, but I\nthink also true for some system package setups (e.g., Debian's \"git\"\npackage ships the manpages, but you don't get the html versions unless\nyou install \"git-doc\" as well).\n\n-Peff\n"},{"id":"416207","messageId":"YBxim/CGZAzttpoN@coredump.intra.peff.net","threadId":"55108","inReplyTo":"bda4965e57c74f2a8f855ab7d92e71ca@astronics.com","subject":"Re: howto-index not found","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2021-02-04T21:09:47Z","receivedAt":"2021-02-04T21:10:36Z","isPatch":false,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Thu, Feb 04, 2021 at 08:34:18PM +0000, Bulgrien, Dennis wrote:\n\n> The github tracker redirects back to this group, saying \"These pages\n> are generated from git man pages, so we have no control over it. Have\n> you reported it to the community at https://git-scm.com/community ?\"\n> \n> [1]: https://github.com/git/git-scm.com/issues/1521\n\nYeah, there are sort of two questions here:\n\n - should git-scm.com be generating the howto-index, api-index, etc;\n that's an issue that would be solved there (because it has custom\n code to import and format the documentation from git.git).\n\n - should Documentation/git.txt be more careful about referencing\n potentially-absent html files from the manpage builds. That's an\n issue that should be solved here on the mailing list.\n\n-Peff\n"}]}