Package: svn-buildpackage Version: 0.6.18 Severity: minor -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
The manpage(s) contain a few issues: * Options are not separated: [..] --svn-lintian--svn-linda [..] [..] --svn-prebuild--svn-postbuild--svn-pretag--svn-posttag [..] * The manpage contains two sections called "OPTIONS". But the first probably should be "DESCRIPTION". * The options mentioned in "OPTIONS" (in both sections) probably should also be bold to emphasize them: e.g. in [..] option may break --svn-lintian, --svn-linda and --svn-move functionality [..] the options ishould be bold too to emphasize them. * Further the manpage references in "SEE ALSO" do not follow the manpage recommendations, that say, that the referenced refentry should be bold (refer to http://www.schweikhardt.net/man_page_howto.html#q3 -> "The SEE ALSO section" and http://www.schweikhardt.net/man_page_howto.html#q8 -> "Any reference to another man page [..]"). * The "AUTHOR" sections contains an invalid UTF-8 character ( to SGML by Gonéri Le Bouder). You should try to use the groff code for this character. I'm not familar with the docbook-utils package, that seems to be used to create the manpages. The docbook-xsl stylesheets provide the following parameters to fix some of these issues: /usr/share/doc/docbook-xsl-doc-html/doc/manpages/variablelist.term.separator.html /usr/share/doc/docbook-xsl-doc-html/doc/manpages/variablelist.term.break.after.html (define handling of option lists realized with the variablelist element) /usr/share/doc/docbook-xsl-doc-html/doc/manpages/man.charmap.use.subset.html (set to zero to escape all UTF-8 characters) The docbook-xsl package contains an example of a manpage written in DocBook XML, that shows the current power and usage of DocBook to write manpages. Regards, Daniel - -- System Information: Debian Release: lenny/sid APT prefers unstable APT policy: (850, 'unstable'), (700, 'testing'), (550, 'stable'), (110, 'experimental') Architecture: i386 (i686) Kernel: Linux 2.6.18.11 (PREEMPT) Locale: LANG=de_DE, LC_CTYPE=de_DE (charmap=ISO-8859-1) Shell: /bin/sh linked to /bin/bash Versions of packages svn-buildpackage depends on: ii devscripts 2.10.2 Scripts to make the life of a Debi ii file 4.20-4 Determines file type using "magic" ii libsvn-perl 1.4.2dfsg1-2 Perl bindings for Subversion ii perl 5.8.8-7 Larry Wall's Practical Extraction ii subversion 1.4.2dfsg1-2 Advanced version control system ii unp 1.0.12 unpack (almost) everything with on ii wget 1.10.2-2 retrieves files from the web svn-buildpackage recommends no packages. - -- no debconf information -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.6 (GNU/Linux) iD8DBQFGHgSxm0bx+wiPa4wRAqykAJ4q/nOfbBdy1CbO9l27P3YgV2x5XgCg1OM5 OlX0+mQtC4XUO5IsbCFbP9o= =3qkg -----END PGP SIGNATURE----- -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
