From: Junio C Hamano Date: Thu, 03 Dec 2009 02:16:08 GMT Subject: Re: [RFC PATCH] Documentation: set a base URL for relative links Message-ID: <7vy6lk7qfr.fsf@alter.siamese.dyndns.org> In-Reply-To: <20091203015005.GH23717@inocybe.localdomain> Todd Zullinger writes: > I don't know the doc toolchain well enough to know how best to fix > this without breaking anything. It would be ideal if the base URL > used was substituted and controllable via make variables. That would > allow packagers to make it point to the on-disk documentation and make > git's documentation even easier to use when disconnected. Thanks. It indeed appears that update to FC11 at k.org brought a few issues to the documentation area. I think we can do something like this and let distro people to decide what URL to use. Documentation/Makefile | 4 ++++ 1 files changed, 4 insertions(+), 0 deletions(-) diff --git a/Documentation/Makefile b/Documentation/Makefile index 3f59952..abb75eb 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -104,6 +104,10 @@ ifdef DOCBOOK_SUPPRESS_SP XMLTO_EXTRA += -m manpage-suppress-sp.xsl endif +ifdef MAN_BASE_URL +XMLTO_EXTRA += --stringparam man.base.url.for.relative.links=$(MAN_BASE_URL) +endif + # If your target system uses GNU groff, it may try to render # apostrophes as a "pretty" apostrophe using unicode. This breaks # cut&paste, so you should set GNU_ROFF to force them to be ASCII