From mboxrd@z Thu Jan 1 00:00:00 1970 From: Todd Zullinger Subject: [RFC PATCH] Documentation: set a base URL for relative links Date: Wed, 2 Dec 2009 20:50:05 -0500 Message-ID: <20091203015005.GH23717@inocybe.localdomain> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii To: git@vger.kernel.org X-From: git-owner@vger.kernel.org Thu Dec 03 02:50:17 2009 Return-path: Envelope-to: gcvg-git-2@lo.gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1NG0pk-00060D-KO for gcvg-git-2@lo.gmane.org; Thu, 03 Dec 2009 02:50:16 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753485AbZLCBuE (ORCPT ); Wed, 2 Dec 2009 20:50:04 -0500 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1753307AbZLCBuD (ORCPT ); Wed, 2 Dec 2009 20:50:03 -0500 Received: from a-pb-sasl-quonix.pobox.com ([208.72.237.25]:62522 "EHLO sasl.smtp.pobox.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752562AbZLCBuC (ORCPT ); Wed, 2 Dec 2009 20:50:02 -0500 Received: from sasl.smtp.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTP id 99FE5843D2 for ; Wed, 2 Dec 2009 20:50:07 -0500 (EST) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=pobox.com; h=date:from:to :subject:message-id:mime-version:content-type; s=sasl; bh=QvibgI NS0IEYiY3mnY/cg4JKzJ8=; b=YmrRtOaQ0xwhUIV/LxLkH3w9vkH6dlICJONAOQ nc/d/Wl5+fhYIXFF6kA/fnSCYhIo1X6PMxhpc7lY9iKwoBbAkz9j5XF3hmi/JbM5 y2ORZyter8m+4K82E4g5CMsGVtx3qC6O8rLfv5fIud/bj0G/SPzStejua3uEyhVX D+mHk= DomainKey-Signature: a=rsa-sha1; c=nofws; d=pobox.com; h=date:from:to :subject:message-id:mime-version:content-type; q=dns; s=sasl; b= VKC4eGDS2TrJR3Tm+ylzGf3wOZjbNhOQworYdfZ8LlbtFb5unnanp2UlYQxclfU2 mYBNBLQZy7pEz8e05w/BkqSVnB2EPpR1oIBAhWhloFMBVC/VHG4w1AquoJn8p4y6 LFfp8KXJwixBQXiQ1ckmf6E0L+iV7NkecvJ3QVQradE= Received: from a-pb-sasl-quonix. (unknown [127.0.0.1]) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTP id 41545843D1 for ; Wed, 2 Dec 2009 20:50:07 -0500 (EST) Received: from inocybe.localdomain (unknown [98.117.251.177]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTPSA id 6CD2D843D0 for ; Wed, 2 Dec 2009 20:50:06 -0500 (EST) Content-Disposition: inline User-Agent: Mutt/1.5.20 (2009-06-14) X-Pobox-Relay-ID: 2EEDCA8C-DFAE-11DE-8DE9-9F3FEE7EF46B-09356542!a-pb-sasl-quonix.pobox.com Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: The man.base.url.for.relative.links setting is used when generating the NOTES sections of various man pages. If unset, the output looks like this: 1. Everyday Git [set $man.base.url.for.relative.links]/everyday.html Reported-by: Michal Schmidt (Fedora bug #543481) Signed-off-by: Todd Zullinger --- This was reported to the Fedora bugzilla. I checked and it's been broken in the Fedora builds for quite a while. In origin/man, the first time it appeared was 3ae5cb60 (Autogenerated manpages for v1.6.5.1-75-g02d56), which looks to be around the time that kernel.org switched from F9 to F11. 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. Any help or suggestions to refine this and test it on various docbook versions would be most welcome. Documentation/manpage-base.xsl | 4 ++++ 1 files changed, 4 insertions(+), 0 deletions(-) diff --git a/Documentation/manpage-base.xsl b/Documentation/manpage-base.xsl index a264fa6..50ce029 100644 --- a/Documentation/manpage-base.xsl +++ b/Documentation/manpage-base.xsl @@ -7,6 +7,10 @@ + +http://www.kernel.org/pub/software/scm/git/docs/ + -- 1.6.6.rc0 -- Todd OpenPGP -> KeyID: 0xBEAF0CE3 | URL: www.pobox.com/~tmz/pgp ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Just because everything is different doesn't mean anything has changed. -- Irene Peter