* howto-index not found
@ 2021-02-04 19:16 Bulgrien, Dennis
2021-02-04 19:58 ` Eric Sunshine
0 siblings, 1 reply; 6+ messages in thread
From: Bulgrien, Dennis @ 2021-02-04 19:16 UTC (permalink / raw)
To: git@vger.kernel.org
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?
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)
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: howto-index not found
2021-02-04 19:16 howto-index not found Bulgrien, Dennis
@ 2021-02-04 19:58 ` Eric Sunshine
2021-02-04 20:27 ` Jeff King
2021-02-04 20:32 ` Bulgrien, Dennis
0 siblings, 2 replies; 6+ messages in thread
From: Eric Sunshine @ 2021-02-04 19:58 UTC (permalink / raw)
To: Bulgrien, Dennis; +Cc: git@vger.kernel.org
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
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: howto-index not found
2021-02-04 19:58 ` Eric Sunshine
@ 2021-02-04 20:27 ` Jeff King
2021-02-04 20:34 ` Bulgrien, Dennis
2021-02-04 20:32 ` Bulgrien, Dennis
1 sibling, 1 reply; 6+ messages in thread
From: Jeff King @ 2021-02-04 20:27 UTC (permalink / raw)
To: Eric Sunshine; +Cc: Bulgrien, Dennis, git@vger.kernel.org
On Thu, Feb 04, 2021 at 02:58:36PM -0500, Eric Sunshine wrote:
> 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
^ permalink raw reply [flat|nested] 6+ messages in thread
* RE: howto-index not found
2021-02-04 19:58 ` Eric Sunshine
2021-02-04 20:27 ` Jeff King
@ 2021-02-04 20:32 ` Bulgrien, Dennis
1 sibling, 0 replies; 6+ messages in thread
From: Bulgrien, Dennis @ 2021-02-04 20:32 UTC (permalink / raw)
To: Eric Sunshine; +Cc: git@vger.kernel.org
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 <sunshine@sunshineco.com>
Sent: Thursday, February 4, 2021 1:59 PM
To: Bulgrien, Dennis <Dennis.Bulgrien@astronics.com>
Cc: git@vger.kernel.org
Subject: Re: howto-index not found
On Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis <Dennis.Bulgrien@astronics.com> 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 <a href="https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fgit-scm.com%2Fdocs%2Fhowto-index&data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C4480515b1d654da4745e08d8c94749e0%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480655312867779%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&sdata=OrnEHlLMUctVQrZADKPrDMoQl4rLJbEVJpEy%2Br2Fo9E%3D&reserved=0">howtos</a>"' 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)
^ permalink raw reply [flat|nested] 6+ messages in thread
* RE: howto-index not found
2021-02-04 20:27 ` Jeff King
@ 2021-02-04 20:34 ` Bulgrien, Dennis
2021-02-04 21:09 ` Jeff King
0 siblings, 1 reply; 6+ messages in thread
From: Bulgrien, Dennis @ 2021-02-04 20:34 UTC (permalink / raw)
To: Jeff King, Eric Sunshine; +Cc: git@vger.kernel.org
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 <peff@peff.net>
Sent: Thursday, February 4, 2021 2:27 PM
To: Eric Sunshine <sunshine@sunshineco.com>
Cc: Bulgrien, Dennis <Dennis.Bulgrien@astronics.com>; 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
> <Dennis.Bulgrien@astronics.com> 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 <a href="https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fgit-scm.com%2Fdocs%2Fhowto-index&data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C35dd885da77a4dcd278c08d8c94b440e%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480672478665490%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&sdata=JC7dUie72RpiB6kAqXULNBh8FDM43zuF9e1RDUJGzhE%3D&reserved=0">howtos</a>"' 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)
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: howto-index not found
2021-02-04 20:34 ` Bulgrien, Dennis
@ 2021-02-04 21:09 ` Jeff King
0 siblings, 0 replies; 6+ messages in thread
From: Jeff King @ 2021-02-04 21:09 UTC (permalink / raw)
To: Bulgrien, Dennis; +Cc: Eric Sunshine, git@vger.kernel.org
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
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2021-02-04 21:12 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-02-04 19:16 howto-index not found Bulgrien, Dennis
2021-02-04 19:58 ` Eric Sunshine
2021-02-04 20:27 ` Jeff King
2021-02-04 20:34 ` Bulgrien, Dennis
2021-02-04 21:09 ` Jeff King
2021-02-04 20:32 ` Bulgrien, Dennis
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).