Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase

From: Jay Soffian <jaysoffian@gmail.com>
Date: Mar 11, 2009, 15:39 UTC
Message-ID: <76718490903110839m17041c7bxd7912eb09496c81a@mail.gmail.com>
In-Reply-To: <76718490903110812t5e1723ebi28a84da680422d8a@mail.gmail.com>

On Wed, Mar 11, 2009 at 11:12 AM, Jay Soffian <jaysoffian@gmail.com> wrote:

Show 6 quoted lines

> And your man pages still won't be perfect. Preformatted text will look
> like this:
>
>  .ft C
>          ...
>  .ft

Hmm. git-help.txt has this text:

---snip---
------------------------------------------------
	[man]
		viewer = konqueror
		viewer = woman
------------------------------------------------
---snap---

Which gets translated to:

---snip---
<literallayout>
&#10;.ft C&#10;        [man]
                viewer = konqueror
                viewer = woman&#10;.ft&#10;
</literallayout>
---snap---

While git-push has this text:

---snip--- + -------------------------- git push public #1 git push --repo=public #2 -------------------------- + ---snap---

Which gets translated to:

---snip--- <screen>git push public #1 git push --repo=public #2</screen> ---snap---

Both appear to render identically after being transformed into html, but the transformation to man pages leaves the ".ft C" and ".ft" macros literally in the resultant text. This is using asciidoc 8.3.1 and docbook-xsl 1.74.0. Further investigation is in order, but the transformation from asciidoc to man pages is currently deep magic to me.

j.