Am Sonntag, den 30.03.2008, 13:59 -0700 schrieb Daniel Burrows: > The aptitude manpage, which is generated using docbook, triggers > lintian errors: > > W: aptitude: manpage-has-errors-from-man usr/share/man/man8/aptitude.8.gz > 444: warning: `deb' not defined (probable missing space after `de') > > I tracked this down to the following groff code: > > .RS 4 > Removes all previously downloaded > .deb > files from the package cache directory (usually > \fI/var/cache/apt/archives\fR)\. > .RE > > The manpage output produced for this is "Removes all previously > downloaded files from the package cache directory..."; the ".deb" just > vanishes. The corresponding DocBook XML is: > > > <para> > Removes all previously downloaded <literal>.deb</literal> files > from the package cache > directory (usually <filename>/var/cache/apt/archives</filename>). > </para> > > Apparently docbook-xsl doesn't escape leading periods inside > <literal>, causing the manpage formatter to get confused and think that > the line in question is a ROFF escape.
Thanks for the report. Upstream discovered this bug and I backported the patch to the package update -4 of docbook-xsl, which is waiting (since last night) to be uploaded [1] by my sponsor. However, if the problem hurts you, you could sponsor the package for me (CCing my usual sponsor Michael Banck) or simply download and use it to fix the problem locally. The update also fixes the problem with the French version of the aptitude manpage (#473244). BTW: Michael Smith (one of the project leaders of docbook-xsl) added some kind of regression tests for the docbook-xsl manpage stylesheets (mostly Debian package manpages). aptitude is not yet part of them - but if your manpage sources can be retrieved via some VCS, you could tell him or me the location and they could then be added to [2]. [1] http://debian.wgdd.de/debian/incoming/packages/debian-xml-sgml/docbook-xsl_1.73.2.dfsg.1-4.dsc [2] http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/contrib/samples/refentry/ Regards, Daniel
