git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: Git documentation at kernel.org

From
Junio C Hamano <gitster@pobox.com>
Date
Feb 13, 2012, 03:23 UTC
Message-ID
<7vmx8nju1k.fsf@alter.siamese.dyndns.org>
In-Reply-To
<20120213003024.GA25794@sigill.intra.peff.net>
Jeff King <peff@peff.net> writes:
Show 8 quoted lines
> That sounds great to me. I'd like to be link-compatible with the old
> kernel.org docs section (even if through redirects) so that old links
> work (assuming kernel.org gives us a wholesale redirect).  Which means
> importing all of the docs for released versions. I don't know if the old
> kernel.org doc tree was saved anywhere, but if I understand correctly,
> they are identical to what's in the "git-htmldocs" repository (which I
> _thought_ Junio wasn't going to keep updating, but it seems pretty up to
> date).

I have been updating htmldocs/manpages repositories on "unless I forget" basis every time the public 'master' gets updated, so they are updated as frequently as they used to back when they were autogenerated, "unless I forget".

But the contents of htmldocs does _not_ match what used to be at k.org in that its git.html does not have links to documentation pages for older releases, iow, formatted without "stalenotes" defined.

This is because formatting with "stalenotes" needs to make an assumption on the filesystem layout that I cannot enforce to the users of htmldocs repository. They will get one tarball for one version, and it is up to them where they extract these tarballs. They need to extract the tarball of an older release vX.Y.Z in vX.Y.Z subdirectory next to the git.html of the latest living document to match the layout, but otherwise the links created by "stalenotes" will become dangling.

Previous: Jeff KingNext: Jeff King
Message 18 of 21 in “Git documentation at kernel.org”
  1. Petr OnderkaFeb 7, 2012
  2. Clemens BuchacherFeb 8, 2012
  3. Junio C HamanoFeb 10, 2012
  4. Matthieu MoyFeb 10, 2012
  5. Theodore TsoFeb 10, 2012
  6. Konstantin RyabitsevFeb 10, 2012
  7. Ted Ts'oFeb 10, 2012
  8. Junio C HamanoFeb 10, 2012
  9. Ted Ts'oFeb 10, 2012
  10. Junio C HamanoFeb 10, 2012
  11. Jeff KingFeb 10, 2012
  12. Junio C HamanoFeb 10, 2012
  13. Jeff KingFeb 10, 2012
  14. Matthieu MoyFeb 12, 2012
  15. Jeff KingFeb 12, 2012
  16. Scott ChaconFeb 12, 2012
  17. Jeff KingFeb 13, 2012
  18. Junio C HamanoFeb 13, 2012
  19. Jeff KingFeb 14, 2012
  20. Konstantin RyabitsevFeb 13, 2012
  21. Neal KreitzingerFeb 10, 2012

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.