# [PATCH 2/2] tweak manpage formatting

5 messages from 2007-08-10 to 2007-08-10. Participants: Junio C Hamano, Brian Gernhardt, Carlos Rica.
Thread: https://gitlist.dev/t/9468

## Junio C Hamano, 2007-08-10 07:49

Subject: [PATCH 2/2] tweak manpage formatting
Message-ID: <7vbqdfvng9.fsf@assigned-by-dhcp.cox.net>
URL: https://gitlist.dev/e/7vbqdfvng9.fsf%40assigned-by-dhcp.cox.net

```
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>

```

## Brian Gernhardt, 2007-08-10 15:59

Subject: Re: [PATCH 2/2] tweak manpage formatting
Message-ID: <0F764326-63E8-447D-A2D4-E56E999775D7@silverinsanity.com>
URL: https://gitlist.dev/e/0F764326-63E8-447D-A2D4-E56E999775D7%40silverinsanity.com
In-Reply-To: <7vbqdfvng9.fsf@assigned-by-dhcp.cox.net>

```

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

```

## Junio C Hamano, 2007-08-10 17:17

Subject: Re: [PATCH 2/2] tweak manpage formatting
Message-ID: <7v3ayrtil5.fsf@assigned-by-dhcp.cox.net>
URL: https://gitlist.dev/e/7v3ayrtil5.fsf%40assigned-by-dhcp.cox.net
In-Reply-To: <0F764326-63E8-447D-A2D4-E56E999775D7@silverinsanity.com>

```
Thanks, I'll revert that one.

```

## Carlos Rica, 2007-08-10 19:16

Subject: Re: [PATCH 2/2] tweak manpage formatting
Message-ID: <1b46aba20708101216s7660741ds5ef4c4c0fd13b45c@mail.gmail.com>
URL: https://gitlist.dev/e/1b46aba20708101216s7660741ds5ef4c4c0fd13b45c%40mail.gmail.com
In-Reply-To: <7v3ayrtil5.fsf@assigned-by-dhcp.cox.net>

```
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.
>
>

```

## Brian Gernhardt, 2007-08-10 19:32

Subject: Re: [PATCH 2/2] tweak manpage formatting
Message-ID: <3BCFD157-64CE-408E-BFE8-C720A9FAE080@silverinsanity.com>
URL: https://gitlist.dev/e/3BCFD157-64CE-408E-BFE8-C720A9FAE080%40silverinsanity.com
In-Reply-To: <1b46aba20708101216s7660741ds5ef4c4c0fd13b45c@mail.gmail.com>

```

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

```
