git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: RFC: default version of the documentation tool chain (git 1.7)

From
Junio C Hamano <gitster@pobox.com>
Date
Aug 12, 2009, 02:53 UTC
Message-ID
<7v8whpbv4x.fsf@alter.siamese.dyndns.org>
In-Reply-To
<4A8139C5.9030703@drmicha.warpmail.net>
Michael J Gruber <git@drmicha.warpmail.net> writes:
Show 7 quoted lines
> 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?

Show 5 quoted lines
> 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.
Previous: Michael J Gruber
Message 2 of 2 in “RFC: default version of the documentation tool chain (git 1.7)”
  1. Michael J GruberAug 11, 2009
  2. Junio C HamanoAug 12, 2009

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.