Re: [RFC PATCH] Documentation: set a base URL for relative links
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Dec 3, 2009, 02:16 UTC
- Message-ID
- <7vy6lk7qfr.fsf@alter.siamese.dyndns.org>
- In-Reply-To
- <20091203015005.GH23717@inocybe.localdomain>
Todd Zullinger <tmz@pobox.com> writes:
Show 5 quoted lines
> 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