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

Re: Bad Man Page URLs

From
Junio C Hamano <gitster@pobox.com>
Date
Apr 6, 2012, 07:15 UTC
Message-ID
<7vzkap1gck.fsf@alter.siamese.dyndns.org>
In-Reply-To
<20120406054637.GA25301@sigill.intra.peff.net>
Jeff King <peff@peff.net> writes:
> 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.

-- >8 -- #!/bin/sh

version=$(git describe --exact) && label=$(echo "$version" | sed -e 's|^v||') && version=$(echo "$label" | sed -e 's|-|.|g') || exit

make clean && make dist &&

ASCIIDOC_NO_ROFF=YesPlease \ ASCIIDOC8=YesPlease \ MAN_BASE_URL="git-htmldocs/" \ make dist-doc || exit

# The above used to be # MAN_BASE_URL="http://www.kernel.org/pub/software/scm/git/docs/"

files="
	git-$version.tar.gz
	git-htmldocs-$version.tar.gz
	git-manpages-$version.tar.gz
"
for file in $files
do
	test -f $file || exit
done
sha1sum $files | gpg --clearsign >git-$version.sign
ls -l git-$version.sign $files
Previous: Jonathan NiederNext: Jeff King
Message 7 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.