Package: debhelper Version: 5.0.37.3 Severity: wishlist Tags: patch -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
Hello, I would like to request an update of the manpage.xml.ex example, dh_make uses. After docbook-xsl 1.70.1 reached Debian Sid, the current example will clash with the stylesheets: - - the mail address should me moved into the author element and a contrib element should be added - - the self-written AUTHOR section should be removed - the latest docbook-xsl package automatically creates an AUTHOR section and it also adds a COPYRIGHT section, that contains the copyright (copyright element) and license information (legalnotice element). - - several options inside a variablelist, should be put in several term elements (this behaviour is now controlled via the variablelist.term.separator and variablelist.term.break.after parameters) and not in one term element by default - - the copyright year should be set to 2006 manually or replaced by dh_make too - - referencing manpages should be done using the citerefentry element IMHO the DocBook DTD can be raised to 4.4 too. I attached a sample manpage.xml.ex, which improves the content and adds some more sections samples, you can find in manpages (only sections also mentioned in the Linux Man Page Howto). Have a look at it and tell me your opinion. I've attached a sample manpage resulting from the example too. Regards, Daniel - -- System Information: Debian Release: testing/unstable APT prefers unstable APT policy: (850, 'unstable'), (700, 'testing'), (550, 'stable'), (110, 'experimental') Architecture: i386 (i686) Shell: /bin/sh linked to /bin/bash Kernel: Linux 2.6.15.08060320 Locale: LANG=de_DE, LC_CTYPE=de_DE (charmap=ISO-8859-1) Versions of packages debhelper depends on: ii binutils 2.17-2 The GNU assembler, linker and bina ii coreutils 5.97-3 The GNU core utilities ii dpkg-dev 1.13.22 package building tools for Debian ii file 4.17-3 Determines file type using "magic" ii html2text 1.3.2a-3 An advanced HTML to text converter ii perl 5.8.8-6.1 Larry Wall's Practical Extraction ii po-debconf 1.0.5 manage translated Debconf template debhelper recommends no packages. - -- no debconf information -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (GNU/Linux) iD8DBQFE5Jstdg0kG0+YFBERAq0NAJwL3COanBgfPjMd8Lo8Octaf1ZRVACbBw6J 4rBswIqXELRggVfBxy3ymRI= =BcCY -----END PGP SIGNATURE-----
manpage.xml.ex
Description: Binary data
