threads / patch / 9468

patch, 2 partstweak manpage formatting

Subject: [PATCH 2/2] tweak manpage formatting

## tl;dr

5 messages between Aug 10, 2007 and Aug 10, 2007. Diffs are folded; open one to read it.

replies: 4people: 3as markdown or json

Junio C Hamano· Aug 10, 2007, 07:49 UTC · lore

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(-)
Show changes to Documentation/callouts.xsl +13 −0
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· Aug 10, 2007, 15:59 UTC · re: Junio C Hamano · lore

Re: [PATCH 2/2] tweak manpage formatting

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
Carlos Rica· Aug 10, 2007, 19:16 UTC · re: Junio C Hamano · lore

Re: [PATCH 2/2] tweak manpage formatting

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· Aug 10, 2007, 19:32 UTC · re: Carlos Rica · lore

Re: [PATCH 2/2] tweak manpage formatting

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

← back to recent threads