[PATCH 2/2] tweak manpage formatting

[PATCH 2/2] tweak manpage formatting

[Junio C Hamano]

This attempts to force fixed-font in manpages for literal
blocks.  I have tested this with docbook 1.71 and it seems to
work as expected.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
---

 * The illustration in git-rev-parse.1 is much easier to read
   with this...

 Documentation/callouts.xsl |   13 +++++++++++++
 1 files changed, 13 insertions(+), 0 deletions(-)

diff --git a/Documentation/callouts.xsl b/Documentation/callouts.xsl
index 6a361a2..7941af7 100644
--- a/Documentation/callouts.xsl
+++ b/Documentation/callouts.xsl
@@ -27,4 +27,17 @@
   </xsl:if>
 </xsl:template>
 
+<xsl:template match="literallayout[@class='monospaced']">
+  <xsl:text>.RS</xsl:text>
+  <xsl:if test="not($man.indent.width = '')">
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$man.indent.width"/>
+  </xsl:if>
+  <xsl:text>&#10;</xsl:text>
+  <xsl:text>&#10;.ft C&#10;.nf&#10;</xsl:text>
+  <xsl:apply-templates/>
+  <xsl:text>&#10;.fi&#10;.ft&#10;</xsl:text>
+  <xsl:text>.RE&#10;</xsl:text>
+</xsl:template>
+
 </xsl:stylesheet>

Re: [PATCH 2/2] tweak manpage formatting

[Brian Gernhardt]

On Aug 10, 2007, at 3:49 AM, Junio C Hamano wrote:

> This attempts to force fixed-font in manpages for literal
> blocks.  I have tested this with docbook 1.71 and it seems to
> work as expected.

This broke building the manpages with docbook-xsl 1.69.  Apparently  
it doesn't understand "man.indent.width".  I fixed it by updating to  
1.71 from fink.  I don't know if 1.71 is the minimum supported  
version so thought this might be worth a note.

~~ Brian

Re: [PATCH 2/2] tweak manpage formatting

[Junio C Hamano]

Thanks, I'll revert that one.

Re: [PATCH 2/2] tweak manpage formatting

[Carlos Rica]

I think this was because the end-of-line backslash "\" in the ASCII
art diagram in the Documentation/git-rev-parse.txt.

I think it should be an interesting feature for asciidoc to have long \
lines broken in text version, if only would be a way to disable it.

Tried someone to escape that backslash with another backslash before
(as in "\\")?

2007/8/10, Junio C Hamano <gitster@pobox.com>:
> Thanks, I'll revert that one.
>
>

Re: [PATCH 2/2] tweak manpage formatting

[Brian Gernhardt]

On Aug 10, 2007, at 3:16 PM, Carlos Rica wrote:

> I think this was because the end-of-line backslash "\" in the ASCII
> art diagram in the Documentation/git-rev-parse.txt.

No, it was complaining about unknown "man.indent.width" in  
callout.xsl.  Apparently docbook-xsl 1.69 doesn't like that.   
Updating it to 1.71 made it work again.  I lost the original error  
while updating before sending the first mail, unfortunately.  If it's  
truly needed, I probably still have the 1.69 deb file on my computer  
somewhere.

~~ Brian