From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 03 Dec 2009 22:30:41 GMT
Subject: Re: [ANNOUNCE] Git 1.6.5.4
Message-ID: <7vbpif4rn2.fsf@alter.siamese.dyndns.org>
In-Reply-To: <20091203220020.GS23717@inocybe.localdomain>

Todd Zullinger <tmz@pobox.com> writes:

> I tested with this in Documentation/manpage-base.xsl on a CentOS 5 box
> and it builds fine, leaving no cruft in the man pages regarding the
> man.base.url...
>
> <!-- set a base URL for relative links -->
> <xsl:param name="man.base.url.for.relative.links"
>        >/path/to/git/docs</xsl:param>
>
> Of course, the relative links looked just like they did in older
> docbook releases:
>
>        1. Everyday Git
>           everyday.html
>
> Is it worth the effort to have @@MAN_BASE_URL@@ in
> Documentation/manpage-base.xsl or similar and replace it at build
> time?

I think it depends on the likelihood that a distro has xmlto so old that
it does not understand --stringparam yet it uses stylesheet so new that
setting the parameter makes a positive difference (either it gives the
full URL or at least squelches the "You should define the parameter"
noise) in the output.

I am guessing that the answer would be that is a very unlikely combination
and not worth worrying about it, but I've been wrong before in this exact
area ;-)