From: Jay Soffian <jaysoffian@gmail.com>
Date: Wed, 11 Mar 2009 15:39:06 GMT
Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase
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:
> 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.