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

Re: Bad Man Page URLs

From
Jonathan Nieder <jrnieder@gmail.com>
Date
Apr 6, 2012, 06:17 UTC
Message-ID
<20120406061717.GB3911@burratino>
In-Reply-To
<20120406054637.GA25301@sigill.intra.peff.net>
Jeff King wrote:
> 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/...".
Could be as simple as this, no?
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
---
 Documentation/Makefile |   10 ++++++++--
 Makefile               |    1 +
 2 files changed, 9 insertions(+), 2 deletions(-)
diff --git i/Documentation/Makefile w/Documentation/Makefile
index d40e211f..0edad3a2 100644
--- i/Documentation/Makefile
+++ w/Documentation/Makefile
@@ -248,8 +248,14 @@ $(MAN_HTML): %.html : %.txt
 		$(ASCIIDOC_EXTRA) -agit_version=$(GIT_VERSION) -o $@+ $< && \
 	mv $@+ $@
 
-manpage-base-url.xsl: manpage-base-url.xsl.in
-	sed "s|@@MAN_BASE_URL@@|$(MAN_BASE_URL)|" $< > $@
+manpage-base-url.xsl: manpage-base-url.xsl.in FORCE
+	$(QUIET_GEN)$(RM) $@+ && \
+	sed "s|@@MAN_BASE_URL@@|$(MAN_BASE_URL)|" $< > $@+ && \
+	if test -e $@ && cmp -s $@+ $@; then \
+		$(RM) $@+; \
+	else \
+		mv $@+ $@; \
+	fi
 
 %.1 %.5 %.7 : %.xml manpage-base-url.xsl
 	$(QUIET_XMLTO)$(RM) $@ && \
diff --git i/Makefile w/Makefile
index be1957a5..ce6f805c 100644
--- i/Makefile
+++ w/Makefile
@@ -2623,6 +2623,7 @@ dist-doc:
 	$(RM) -r .doc-tmp-dir
 	mkdir -p .doc-tmp-dir/man1 .doc-tmp-dir/man5 .doc-tmp-dir/man7
 	$(MAKE) -C Documentation DESTDIR=./ \
+		MAN_BASE_URL=git-htmldocs/ \
 		man1dir=../.doc-tmp-dir/man1 \
 		man5dir=../.doc-tmp-dir/man5 \
 		man7dir=../.doc-tmp-dir/man7 \
Previous: Jeff KingNext: Junio C Hamano
Message 6 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.