From: Junio C Hamano <gitster@pobox.com>
Date: Wed, 12 Aug 2009 02:53:18 GMT
Subject: Re: RFC: default version of the documentation tool chain (git 1.7)
Message-ID: <7v8whpbv4x.fsf@alter.siamese.dyndns.org>
In-Reply-To: <4A8139C5.9030703@drmicha.warpmail.net>

Michael J Gruber <git@drmicha.warpmail.net> writes:

> The current defaults for building the documentation are so that asciidoc
> up to 7.1.2 and docbook-xsl 1.69.0 and 1.71.1 need no extra settings,
> whereas all other versions need extra options (1 or more of ASCIIDOC8,
> ASCIIDOC_NO_ROFF, DOCBOOK_XSL_172, DOCBOOK_SUPPRESS_SP), see below. This
> basically means that all current distros need extra options.
>
> I suggest changing the defaults for the git-1.7 cycle.

Do you mean that people with older asciidoc would set a new option, say
ASCIIDOC7, instead of not setting ASCIIDOC8?

> Based on that, I suggest the following defaults for the git-1.7
> documentation build file:
> - ASCIIDOC8=yes. Caters for everything non-EOLed (8.0 and above)
> - ASCIIDOC_NO_ROFF=yes. Caters for everything non-EOLed (1.73 and above,
> 1.68.1 and below)

I would say that is a sensible default.