[PATCH 2/2] tweak manpage formatting

Previous thread: How to work with submodule? by Steffen Prohaska on Friday, August 10, 2007 - 3:02 am. (2 messages)

Next thread: [PATCH 1/2] Fix an illustration in git-rev-parse.txt by Junio C Hamano on Friday, August 10, 2007 - 3:49 am. (2 messages)
To: <git@...>
Cc: Carlos Rica <jasampler@...>
Date: Friday, August 10, 2007 - 3:49 am

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>

-

To: Junio C Hamano <gitster@...>
Cc: Carlos Rica <jasampler@...>, <git@...>
Date: Friday, August 10, 2007 - 11:59 am

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
-

To: Brian Gernhardt <benji@...>
Cc: Carlos Rica <jasampler@...>, <git@...>
Date: Friday, August 10, 2007 - 1:17 pm

Thanks, I'll revert that one.

-

To: Junio C Hamano <gitster@...>
Cc: Brian Gernhardt <benji@...>, <git@...>
Date: Friday, August 10, 2007 - 3:16 pm

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 "\\")?

-

To: Carlos Rica <jasampler@...>
Cc: Junio C Hamano <gitster@...>, <git@...>
Date: Friday, August 10, 2007 - 3:32 pm

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
-

Previous thread: How to work with submodule? by Steffen Prohaska on Friday, August 10, 2007 - 3:02 am. (2 messages)

Next thread: [PATCH 1/2] Fix an illustration in git-rev-parse.txt by Junio C Hamano on Friday, August 10, 2007 - 3:49 am. (2 messages)