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

Re: Bad Man Page URLs

From
David E. Wheeler <david@justatheory.com>
Date
Apr 26, 2012, 20:12 UTC
Message-ID
<BCD7B631-8C73-4F3F-AB37-9B5CF02655D5@justatheory.com>
In-Reply-To
<7vzkap1gck.fsf@alter.siamese.dyndns.org>
On Apr 6, 2012, at 12:15 AM, Junio C Hamano wrote:
Show 20 quoted lines
>> Junio, what do you think of building the git-manpages-* tarballs (and
>> the git-manpages repo) with MAN_BASE_URL set to "http://some-official-place/"?
>> As of now, they mention "file:///home/junio/...".
> 
> I think git-manpages repo already sets the base to the old k.org location
> (see dodoc.sh in the 'todo' branch), but I forgot about that setting when
> I cobbled together the tarball releasing script to be run on my home box
> in a hurry. The releases used to be cut on a k.org machine and I initially
> planned to stop generating the manpage/html tarballs when we lost shell
> access to it, but some distro people demanded it, so...
> 
> I do not know how well things would behave if we set it to "git-htmldocs/"
> as Jonathan suggests, but we will see what happens.
> 
> I think there is no need to patch any Makefile; the make variable is
> designed to be overridable by the callers of make, so patches should go to
> either 'dodoc.sh' or the tarball release scripts, which are not checked in
> to the 'todo' branch yet, but I will do so if I remember ;-).
> 
> FWIW, here is the (updated) 'RelBuild' script.
Don't know if you've applied this fix, but I just downloaded the 1.7.10 man pages, and they URLs are now:
        1. Everyday Git
           git-htmldocs/everyday.html
        2. Git User's Manual
           git-htmldocs/user-manual.html
        3. git concepts chapter of the user-manual
           git-htmldocs/user-manual.html#git-concepts
        4. howto
           git-htmldocs/howto-index.html
        5. GIT API documentation
           git-htmldocs/technical/api-index.html
Which also aren't very useful. :-(
David
Previous: Jeff KingNext: Jonathan Nieder
Message 9 of 21 in “Bad Man Page URLs”
  1. David E. WheelerApr 6, 2012
  2. Jeff KingApr 6, 2012
  3. Jeff KingApr 6, 2012
  4. Jonathan NiederApr 6, 2012
  5. Jeff KingApr 6, 2012
  6. Jonathan NiederApr 6, 2012
  7. Junio C HamanoApr 6, 2012
  8. Jeff KingApr 6, 2012
  9. David E. WheelerApr 26, 2012
  10. Jonathan NiederApr 26, 2012
  11. David E. WheelerApr 26, 2012
  12. Jonathan NiederApr 26, 2012
  13. David E. WheelerApr 26, 2012
  14. Jakub NarebskiMay 2, 2012
  15. Jeff KingApr 26, 2012
  16. Scott ChaconApr 26, 2012
  17. David E. WheelerApr 26, 2012
  18. Jonathan NiederApr 26, 2012
  19. Junio C HamanoApr 26, 2012
  20. Scott ChaconApr 26, 2012
  21. Jonathan NiederApr 26, 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.