OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Formatting of refsynopsisdiv section in manpages broken with1.74.3


Hi list,

I'm using xsltproc with manpages/docbook.xsl xsl stylesheet from  
1.74.3 to create man pages for the OS project netatalk.
Inbetween 1.71 and 1.74.3 the output has changed: I'm receiving  
warnings on Debian 4 man and mis-formatting on all platforms where  
I've tested the manpages.

The source is [1]:
---8<---
   <refsynopsisdiv>
     <cmdsynopsis>
        
<command>achfile<indexterm><primary>achfile</primary></indexterm></command>
       <arg choice="opt"><arg choice="plain">-t </arg><arg  
choice="plain"><replaceable>type</replaceable></arg></arg>
       <arg choice="opt"><arg choice="plain">-c </arg><arg  
choice="plain"><replaceable>creator</replaceable></arg></arg>
       <arg choice="plain" rep="repeat"><replaceable>file</replaceable></arg>
     </cmdsynopsis>
   </refsynopsisdiv>
---8<---

I've found an older generated manpage from 1.71 which generated this:
---8<---
.SH "SYNOPSIS"
.HP 15
\fBachfile\fR\fB\fR [\-t\ \fItype\fR] [\-c\ \fIcreator\fR] \fIfile\fR...
.SH "DESCRIPTION"
---8<---

1.74.3 generates this:
---8<---
.SH "SYNOPSIS"
.HP \w'\fBachfile\fR\fB.\"\ achfile\ \fR\ 'u
\fBachfile\fR\fB.\" achfile
.PP
\fR [\-t\ \fItype\fR] [\-c\ \fIcreator\fR] \fIfile\fR...
.SH "DESCRIPTION"
---8<---

Which generates a warning with Debian 4 man:
./achfile.1:26: warning [p 1, 1,5i]: can't break line
./achfile.1:26: warning [p 1, 1,7i]: can't break line
./achfile.1:26: warning [p 1, 1,8i]: can't break line

The output looks like this on all platforms:
---8<---
SYNOPSIS
        achfile.

                                                        [-t type]

                                                       [-c creator]

                                                       file...
---8<---

With 1.71 it looks like this:
---8<---
SYNOPSIS
        achfile [-t type] [-c creator] file...
---8<---

My xsl file is [2].

Help is highly appreciated!

Regards
-Ralph


[1] Complete file:
http://netatalk.cvs.sourceforge.net/viewvc/netatalk/netatalk-docs/manual/man/man1/achfile.1.xml?revision=1.4&view=markup

[2]
http://netatalk.cvs.sourceforge.net/viewvc/netatalk/netatalk-docs/manual/man.xsl?revision=1.5&view=markup


----------------------------------------------------------------
This message was sent using IMP, the Internet Messaging Program.



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]