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.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
