Your message dated Wed, 09 May 2012 17:17:24 +0000
with message-id <[email protected]>
and subject line Bug#670210: fixed in debhelper 9.20120509
has caused the Debian Bug report #670210,
regarding debhelper: Support for mdoc section detection in dh_installman
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)
--
670210: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=670210
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Source: debhelper
Source-Version: 9.20120419
Severity: wishlist
Tags: patch
Hi!
Here's a patch to add support for mdoc(7) section detection from .Dt
man page entries.
I've reflowed the documentation to make it fit again on a standard
screen, if you'd want less “gratuituous” diff I can prepare another
patch.
thanks,
guillem
>From d77f83846f63fa1afbcffef8ba451d6b28899cbe Mon Sep 17 00:00:00 2001
From: Guillem Jover <[email protected]>
Date: Tue, 24 Apr 2012 05:22:57 +0200
Subject: [PATCH] dh_installman: Recognize sections from mdoc .Dt entries
---
dh_installman | 26 ++++++++++++++------------
1 file changed, 14 insertions(+), 12 deletions(-)
diff --git a/dh_installman b/dh_installman
index e118281..52d1e6b 100755
--- a/dh_installman
+++ b/dh_installman
@@ -18,22 +18,23 @@ B<dh_installman> [S<I<debhelper options>>] [S<I<manpage> ...>]
B<dh_installman> is a debhelper program that handles installing
man pages into the correct locations in package build directories. You tell
-it what man pages go in your packages, and it figures out where to
-install them based on the section field in their B<.TH> line. If you have a
-properly formatted B<.TH> line, your man page will be installed into the right
-directory, with the right name (this includes proper handling of pages
-with a subsection, like B<3perl>, which are placed in F<man3>, and given an
-extension of F<.3perl>). If your B<.TH> line is incorrect or missing, the program
-may guess wrong based on the file extension.
+it what man pages go in your packages, and it figures out where to install
+them based on the section field in their B<.TH> or B<.Dt> line. If you have
+a properly formatted B<.TH> or B<.Dt> line, your man page will be installed
+into the right directory, with the right name (this includes proper handling
+of pages with a subsection, like B<3perl>, which are placed in F<man3>, and
+given an extension of F<.3perl>). If your B<.TH> or B<.Dt> line is incorrect
+or missing, the program may guess wrong based on the file extension.
It also supports translated man pages, by looking for extensions
like F<.ll.8> and F<.ll_LL.8>, or by use of the B<--language> switch.
If B<dh_installman> seems to install a man page into the wrong section or with
the wrong extension, this is because the man page has the wrong section
-listed in its B<.TH> line. Edit the man page and correct the section, and
-B<dh_installman> will follow suit. See L<man(7)> for details about the B<.TH>
-section. If B<dh_installman> seems to install a man page into a directory
+listed in its B<.TH> or B<.Dt> line. Edit the man page and correct the
+section, and B<dh_installman> will follow suit. See L<man(7)> for details
+about the B<.TH> section, and L<mdoc(7)> for the B<.Dt> section. If
+B<dh_installman> seems to install a man page into a directory
like F</usr/share/man/pl/man1/>, that is because your program has a
name like F<foo.pl>, and B<dh_installman> assumes that means it is translated
into Polish. Use B<--language=C> to avoid this.
@@ -118,7 +119,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
}
my $section;
- # See if there is a .TH entry in the man page. If so,
+ # See if there is a .TH or .Dt entry in the man page. If so,
# we'll pull the section field from that.
if ($gz) {
open (IN, "zcat $page|") or die "$page: $!";
@@ -127,7 +128,8 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
open (IN, $page) or die "$page: $!";
}
while (<IN>) {
- if (/^\.TH\s+\S+\s+"?(\d+[^"\s]*)"?/) {
+ if (/^\.TH\s+\S+\s+"?(\d+[^"\s]*)"?/ ||
+ /^\.Dt\s+\S+\s+(\d+[^\s]*)/) {
$section=$1;
last;
}
--
1.7.10
--- End Message ---
--- Begin Message ---
Source: debhelper
Source-Version: 9.20120509
We believe that the bug you reported is fixed in the latest version of
debhelper, which is due to be installed in the Debian FTP archive:
debhelper_9.20120509.dsc
to main/d/debhelper/debhelper_9.20120509.dsc
debhelper_9.20120509.tar.gz
to main/d/debhelper/debhelper_9.20120509.tar.gz
debhelper_9.20120509_all.deb
to main/d/debhelper/debhelper_9.20120509_all.deb
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to [email protected],
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Joey Hess <[email protected]> (supplier of updated debhelper package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [email protected])
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Format: 1.8
Date: Wed, 09 May 2012 12:59:15 -0400
Source: debhelper
Binary: debhelper
Architecture: source all
Version: 9.20120509
Distribution: unstable
Urgency: low
Maintainer: Joey Hess <[email protected]>
Changed-By: Joey Hess <[email protected]>
Description:
debhelper - helper programs for debian/rules
Closes: 670210 671598 672109
Changes:
debhelper (9.20120509) unstable; urgency=low
.
* dh_installman: Recognize sections from mdoc .Dt entries. Closes: #670210
Thanks, Guillem Jover
* Updated German man page translation. Closes: #671598
* dh_install: Reorder documentation for clarity. Closes: #672109
Checksums-Sha1:
3e26a17cf00fe2c8504aa2c6747f2baa7dba5645 1577 debhelper_9.20120509.dsc
76202d0862dc6453e4585731b2b1442c53370581 463472 debhelper_9.20120509.tar.gz
8dab484b57f65267c28622064c14b4c265160b88 693768 debhelper_9.20120509_all.deb
Checksums-Sha256:
b9300b4841a5aa4f459b6a68fb68562d67387f88d25ce0611bafbf59d1295017 1577
debhelper_9.20120509.dsc
244564ee392247c6d8aef90e92c4b0b2d71954508db8db9ccf39549fa84c4670 463472
debhelper_9.20120509.tar.gz
452e73942eba3876ade1d1570b339aafe7300307e8d24a25ffd193dbd5c89ad9 693768
debhelper_9.20120509_all.deb
Files:
67ae8e38db017dd93181d1a192a35cf5 1577 devel optional debhelper_9.20120509.dsc
e886babbec4f8219534bdf5ca9f9da36 463472 devel optional
debhelper_9.20120509.tar.gz
3a647111afd089498fbcebad50a08df1 693768 devel optional
debhelper_9.20120509_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)
iQIVAwUBT6qjnskQ2SIlEuPHAQhIuw/6A/mYr5MeoIiGnH7SR27EhnW2YhX0uN+k
ET5BEERoLupDvbgXK8g/GLTe1LjfIKKpD80apiyB09mFczbAOWh32PONM9UYMqci
ZbIBuD00/c2XD+J2e2K0z346d2VmPF6/UM2ahcU/ASUIv/JTFwWthzJh5NWckKnx
xtAXmphjfbVP+CdAqdtqwghpluU8y31lPVGqyuuntxgOc//cpD4ppoeQX3A7uRZp
7tt+8QW0vuWzVDiHnd4OX1w23z/oy02Lfke6Aifwwi/TeJcflhxbItGOPC4aCEtm
n4ExoGvj/mpHC1dkPwGb+lqff/nzFPqT9aPv/xtNsN2e/e24R+Vrj1WdO5v6gydk
vDpEHpbLyW68tf3xf0PX6KGgS2CFWkVUPpBgk50NffTGileXYSyZpV5AFNs+b5lP
sDzA9KSCdHAokQ5+rnSAuoZebqjri16vEF2jcqmcPdKl6FM3Xke2ozUtvUH/raUe
Vb0V1wBYR/FtZxvja1bLRfjD0JRkH0PdKKEH3bH0wBnijnAAJkC7h4CIrHbYuxjC
6bUwyAMSWEHXwsF0b4aL82F5u8l2xXkDpRZeNfpZRC68iNT1wbSJJgO+ep8a2zdk
EDyM8nC6pZj61o2lByouu0EzR+a3zh43pYW3XNF6PxWqYT4oSIGz+ILh7Kz8tsEo
m380oyo34tA=
=pKxO
-----END PGP SIGNATURE-----
--- End Message ---
