Bug#569828: manpages/synop.xsl makes a mess of long function names

[Ben Hutchings]

tags 569828 + patch
thanks

On Sun, 2010-02-14 at 15:48 +0000, Ben Hutchings wrote:
> It seems to me that there should be a break point between the open
> parenthesis and the first parameter and that indentation of the
> following lines should be limited to about half the output width.

Here's a patch to do this.

Unfortunately the '<?' operator is a GNU roff extension and therefore
may not be acceptable upstream.

Ben.

--- docbook-xsl-1.75.2+dfsg.orig/manpages/synop.xsl
+++ docbook-xsl-1.75.2+dfsg/manpages/synop.xsl
@@ -271,6 +271,8 @@
     <xsl:apply-templates select="funcdef"/>
   </xsl:variable>
   <xsl:call-template name="synopsis-block-start"/>
+  <!-- * If the synopsis must be wrapped, indent to just after the -->
+  <!-- * open-parenthesis, or by 32 en, whichever is smaller. -->
   <xsl:text>.HP </xsl:text>
   <xsl:text>\w'</xsl:text>
   <xsl:variable name="funcdef">
@@ -282,6 +284,7 @@
     <xsl:with-param name="replacement" select="'\ '"/>
   </xsl:call-template>
   <xsl:text>('u</xsl:text>
+  <xsl:text>&lt;?32n</xsl:text>
   <xsl:text>&#10;</xsl:text>
   <xsl:text>.</xsl:text>
   <xsl:value-of select="$man.font.funcprototype"/>
@@ -294,6 +297,8 @@
   <xsl:text>"</xsl:text>
   <xsl:value-of select="normalize-space($funcprototype)"/>
   <xsl:text>(</xsl:text>
+  <!-- * Allow line-break here. -->
+  <xsl:text>\:</xsl:text>
   <xsl:choose>
     <xsl:when test="not($style = 'ansi')">
       <xsl:apply-templates select="*[local-name() != 'funcdef']" mode="kr"/>
--- END ---

-- 
Ben Hutchings
The most exhausting thing in life is being insincere. - Anne Morrow Lindberg

signature.asc
Description: This is a digitally signed message part