Add a Makefile and simplify this package's own rules file using all the new toys.

1 files changed, 112 insertions, 73 deletions

diff --git a/man/po4a/po/debhelper.pot b/man/po4a/po/debhelper.pot
index 6ad9b02b..13264312 100644
--- a/man/po4a/po/debhelper.pot
+++ b/man/po4a/po/debhelper.pot
@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2008-03-25 14:08-0400\n"
+"POT-Creation-Date: 2008-04-23 15:36-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -582,7 +582,7 @@ msgid "This mode works like V2, with the following additions:"
 msgstr ""
 
 # type: =item
-#: debhelper.pod:296 debhelper.pod:301 debhelper.pod:305 debhelper.pod:319 debhelper.pod:324 debhelper.pod:329 debhelper.pod:334 debhelper.pod:346 debhelper.pod:350 debhelper.pod:355 debhelper.pod:359 debhelper.pod:372 debhelper.pod:377 debhelper.pod:383 debhelper.pod:389
+#: debhelper.pod:296 debhelper.pod:301 debhelper.pod:305 debhelper.pod:319 debhelper.pod:324 debhelper.pod:329 debhelper.pod:334 debhelper.pod:346 debhelper.pod:350 debhelper.pod:355 debhelper.pod:359 debhelper.pod:371 debhelper.pod:376 debhelper.pod:382 debhelper.pod:388 debhelper.pod:403
 msgid "-"
 msgstr ""
 
@@ -678,25 +678,25 @@ msgstr ""
 
 # type: textblock
 #: debhelper.pod:367
-msgid "This is the recommended mode of operation. It does everything V5 does, plus:"
+msgid "Changes from V5 are:"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:374
+#: debhelper.pod:373
 msgid ""
 "Commands that generate maintainer script fragements will order the "
 "fragements in reverse order for the prerm and postrm scripts."
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:379
+#: debhelper.pod:378
 msgid ""
 "dh_installwm will install a slave manpage link for x-window-manager.1.gz, if "
 "it sees the man page in usr/share/man/man1 in the package build directory."
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:385
+#: debhelper.pod:384
 msgid ""
 "dh_builddeb did not previously delete everything matching DH_ALWAYS_EXCLUDE, "
 "if it was set to a list of things to exclude, such as \"CVS:.svn:.git\". Now "
@@ -704,19 +704,43 @@ msgid ""
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:391
+#: debhelper.pod:390
 msgid ""
 "dh_installman allows overwriting existing man pages in the package build "
 "directory. In previous compatability levels it silently refuses to do this."
 msgstr ""
 
+# type: =item
+#: debhelper.pod:395
+msgid "V7"
+msgstr ""
+
+# type: textblock
+#: debhelper.pod:397
+msgid "This is the recommended mode of operation."
+msgstr ""
+
+# type: textblock
+#: debhelper.pod:399
+msgid "Changes from V6 are:"
+msgstr ""
+
+# type: textblock
+#: debhelper.pod:405
+msgid ""
+"dh_install, if --sourcedir is not specified, will first look for files in "
+"debian/tmp, and then will look in the current directory. This allows "
+"dh_install to interoperate with dh_auto_install without needing any special "
+"parameters."
+msgstr ""
+
 # type: =head2
-#: debhelper.pod:398
+#: debhelper.pod:414
 msgid "Doc directory symlinks"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:400
+#: debhelper.pod:416
 msgid ""
 "Sometimes it is useful to make a package not contain a "
 "/usr/share/doc/package directory at all, instead placing just a dangling "
@@ -730,12 +754,12 @@ msgid ""
 msgstr ""
 
 # type: =head2
-#: debhelper.pod:409
+#: debhelper.pod:425
 msgid "udebs"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:411
+#: debhelper.pod:427
 msgid ""
 "Debhelper includes support for udebs. To create a udeb with debhelper, add "
 "\"XC-Package-Type: udeb\" to the package's stanza in debian/control, and "
@@ -746,12 +770,12 @@ msgid ""
 msgstr ""
 
 # type: =head2
-#: debhelper.pod:418
+#: debhelper.pod:434
 msgid "Other notes"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:420
+#: debhelper.pod:436
 msgid ""
 "In general, if any debhelper program needs a directory to exist under "
 "debian/, it will create it. I haven't bothered to document this in all the "
@@ -762,7 +786,7 @@ msgid ""
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:426
+#: debhelper.pod:442
 msgid ""
 "Once your package uses debhelper to build, be sure to add debhelper to your "
 "Build-Depends line in debian/control. You should build-depend on a version "
@@ -771,7 +795,7 @@ msgid ""
 msgstr ""
 
 # type: verbatim
-#: debhelper.pod:432
+#: debhelper.pod:448
 #, no-wrap
 msgid ""
 "  Build-Depends: debhelper (>= 6)\n"
@@ -779,51 +803,51 @@ msgid ""
 msgstr ""
 
 # type: =head1
-#: debhelper.pod:434
+#: debhelper.pod:450
 msgid "ENVIRONMENT"
 msgstr ""
 
 # type: =item
-#: debhelper.pod:438
+#: debhelper.pod:454
 msgid "DH_VERBOSE"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:440
+#: debhelper.pod:456
 msgid ""
 "Set to 1 to enable verbose mode. Debhelper will output every command it runs "
 "that modifies files on the build system."
 msgstr ""
 
 # type: =item
-#: debhelper.pod:443
+#: debhelper.pod:459
 msgid "DH_COMPAT"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:445
+#: debhelper.pod:461
 msgid ""
 "Temporarily specifies what compatibility level debhelper should run at, "
 "overriding any value in debian/compat."
 msgstr ""
 
 # type: =item
-#: debhelper.pod:448
+#: debhelper.pod:464
 msgid "DH_NO_ACT"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:450
+#: debhelper.pod:466
 msgid "Set to 1 to enable no-act mode."
 msgstr ""
 
 # type: =item
-#: debhelper.pod:452
+#: debhelper.pod:468
 msgid "DH_OPTIONS"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:454
+#: debhelper.pod:470
 msgid ""
 "Anything in this variable will be prepended to the command line arguments of "
 "all debhelper commands. This is useful in some situations, for example, if "
@@ -833,12 +857,12 @@ msgid ""
 msgstr ""
 
 # type: =item
-#: debhelper.pod:460
+#: debhelper.pod:476
 msgid "DH_ALWAYS_EXCLUDE"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:462
+#: debhelper.pod:478
 msgid ""
 "If set, this adds the value the variable is set to to the -X options of all "
 "commands that support the -X option. Moreover, dh_builddeb will rm -rf "
@@ -846,7 +870,7 @@ msgid ""
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:466
+#: debhelper.pod:482
 msgid ""
 "This can be useful if you are doing a build from a CVS source tree, in which "
 "case setting DH_ALWAYS_EXCLUDE=CVS will prevent any CVS directories from "
@@ -857,44 +881,44 @@ msgid ""
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:473
+#: debhelper.pod:489
 msgid ""
 "Multiple things to exclude can be separated with colons, as in "
 "DH_ALWAYS_EXCLUDE=CVS:.svn"
 msgstr ""
 
 # type: =head1
-#: debhelper.pod:478 dh_builddeb:85 dh_clean:106 dh_compress:189 dh_desktop:47 dh_fixperms:110 dh_gconf:90 dh_gencontrol:73 dh_installcatalogs:111 dh_installchangelogs:125 dh_installcron:61 dh_installdebconf:118 dh_installdeb:94 dh_installdirs:83 dh_installdocs:237 dh_installemacsen:109 dh_installexamples:103 dh_installinfo:103 dh_installinit:197 dh_installlogcheck:51 dh_installlogrotate:50 dh_installmanpages:197 dh_installman:246 dh_installmenu:80 dh_installmime:85 dh_installmodules:116 dh_installpam:52 dh_install:251 dh_installppp:56 dh_installwm:107 dh_installxfonts:86 dh_link:223 dh_listpackages:28 dh_makeshlibs:222 dh_md5sums:86 dh_movefiles:162 dh_perl:152 dh_python:282 dh_scrollkeeper:76 dh_shlibdeps:159 dh_strip:224 dh_suidregister:117 dh_testdir:43 dh_testroot:26 dh_testversion:74 dh_undocumented:28 dh_usrlocal:114
+#: debhelper.pod:494 dh_builddeb:85 dh_clean:109 dh_compress:189 dh_desktop:47 dh_fixperms:110 dh_gconf:90 dh_gencontrol:73 dh_installcatalogs:111 dh_installchangelogs:125 dh_installcron:61 dh_installdebconf:118 dh_installdeb:94 dh_installdirs:83 dh_installdocs:237 dh_installemacsen:109 dh_installexamples:103 dh_installinfo:103 dh_installinit:197 dh_installlogcheck:51 dh_installlogrotate:50 dh_installmanpages:197 dh_installman:249 dh_installmenu:80 dh_installmime:85 dh_installmodules:116 dh_installpam:52 dh_install:268 dh_installppp:56 dh_installwm:107 dh_installxfonts:86 dh_link:223 dh_listpackages:28 dh_makeshlibs:222 dh_md5sums:86 dh_movefiles:162 dh_perl:152 dh_python:282 dh_scrollkeeper:76 dh_shlibdeps:159 dh_strip:224 dh_suidregister:117 dh_testdir:43 dh_testroot:26 dh_testversion:74 dh_undocumented:28 dh_usrlocal:114
 msgid "SEE ALSO"
 msgstr ""
 
 # type: =item
-#: debhelper.pod:482
+#: debhelper.pod:498
 msgid "F</usr/share/doc/debhelper/examples/>"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:484
+#: debhelper.pod:500
 msgid "A set of example debian/rules files that use debhelper."
 msgstr ""
 
 # type: =item
-#: debhelper.pod:486
+#: debhelper.pod:502
 msgid "L<http://kitenet.net/~joey/code/debhelper/>"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:488
+#: debhelper.pod:504
 msgid "Debhelper web site."
 msgstr ""
 
 # type: =head1
-#: debhelper.pod:492 dh_builddeb:91 dh_clean:112 dh_compress:195 dh_desktop:53 dh_fixperms:116 dh_gconf:96 dh_gencontrol:79 dh_installcatalogs:117 dh_installchangelogs:131 dh_installcron:67 dh_installdebconf:124 dh_installdeb:100 dh_installdirs:89 dh_installdocs:243 dh_installemacsen:115 dh_installexamples:109 dh_installinfo:109 dh_installinit:203 dh_installlogcheck:57 dh_installlogrotate:56 dh_installmanpages:203 dh_installman:252 dh_installmenu:88 dh_installmime:91 dh_installmodules:122 dh_installpam:58 dh_install:257 dh_installppp:62 dh_installwm:113 dh_installxfonts:92 dh_link:229 dh_listpackages:34 dh_makeshlibs:228 dh_md5sums:92 dh_movefiles:168 dh_perl:158 dh_python:288 dh_scrollkeeper:82 dh_shlibdeps:165 dh_strip:230 dh_suidregister:123 dh_testdir:49 dh_testroot:32 dh_testversion:80 dh_undocumented:34 dh_usrlocal:120
+#: debhelper.pod:508 dh_builddeb:91 dh_clean:115 dh_compress:195 dh_desktop:53 dh_fixperms:116 dh_gconf:96 dh_gencontrol:79 dh_installcatalogs:117 dh_installchangelogs:131 dh_installcron:67 dh_installdebconf:124 dh_installdeb:100 dh_installdirs:89 dh_installdocs:243 dh_installemacsen:115 dh_installexamples:109 dh_installinfo:109 dh_installinit:203 dh_installlogcheck:57 dh_installlogrotate:56 dh_installmanpages:203 dh_installman:255 dh_installmenu:88 dh_installmime:91 dh_installmodules:122 dh_installpam:58 dh_install:274 dh_installppp:62 dh_installwm:113 dh_installxfonts:92 dh_link:229 dh_listpackages:34 dh_makeshlibs:228 dh_md5sums:92 dh_movefiles:168 dh_perl:158 dh_python:288 dh_scrollkeeper:82 dh_shlibdeps:165 dh_strip:230 dh_suidregister:123 dh_testdir:49 dh_testroot:32 dh_testversion:80 dh_undocumented:34 dh_usrlocal:120
 msgid "AUTHOR"
 msgstr ""
 
 # type: textblock
-#: debhelper.pod:494 dh_builddeb:93 dh_clean:114 dh_compress:197 dh_fixperms:118 dh_gencontrol:81 dh_installchangelogs:133 dh_installcron:69 dh_installdebconf:126 dh_installdeb:102 dh_installdirs:91 dh_installdocs:245 dh_installemacsen:117 dh_installexamples:111 dh_installinfo:111 dh_installinit:205 dh_installlogrotate:58 dh_installmanpages:205 dh_installman:254 dh_installmenu:90 dh_installmime:93 dh_installmodules:124 dh_installpam:60 dh_install:259 dh_installppp:64 dh_installwm:115 dh_installxfonts:94 dh_link:231 dh_listpackages:36 dh_makeshlibs:230 dh_md5sums:94 dh_movefiles:170 dh_shlibdeps:167 dh_strip:232 dh_suidregister:125 dh_testdir:51 dh_testroot:34 dh_testversion:82 dh_undocumented:36
+#: debhelper.pod:510 dh_builddeb:93 dh_clean:117 dh_compress:197 dh_fixperms:118 dh_gencontrol:81 dh_installchangelogs:133 dh_installcron:69 dh_installdebconf:126 dh_installdeb:102 dh_installdirs:91 dh_installdocs:245 dh_installemacsen:117 dh_installexamples:111 dh_installinfo:111 dh_installinit:205 dh_installlogrotate:58 dh_installmanpages:205 dh_installman:257 dh_installmenu:90 dh_installmime:93 dh_installmodules:124 dh_installpam:60 dh_install:276 dh_installppp:64 dh_installwm:115 dh_installxfonts:94 dh_link:231 dh_listpackages:36 dh_makeshlibs:230 dh_md5sums:94 dh_movefiles:170 dh_shlibdeps:167 dh_strip:232 dh_suidregister:125 dh_testdir:51 dh_testroot:34 dh_testversion:82 dh_undocumented:36
 msgid "Joey Hess <joeyh@debian.org>"
 msgstr ""
 
@@ -918,7 +942,7 @@ msgid ""
 msgstr ""
 
 # type: =head1
-#: dh_builddeb:21 dh_clean:25 dh_compress:38 dh_fixperms:31 dh_gconf:34 dh_gencontrol:26 dh_installcatalogs:44 dh_installchangelogs:40 dh_installcron:24 dh_installdebconf:50 dh_installdirs:28 dh_installdocs:51 dh_installemacsen:35 dh_installexamples:29 dh_installinfo:37 dh_installinit:33 dh_installlogrotate:22 dh_installmanpages:40 dh_installman:58 dh_installmenu:34 dh_installmime:31 dh_installmodules:39 dh_installpam:24 dh_install:43 dh_installppp:26 dh_installwm:32 dh_link:48 dh_makeshlibs:28 dh_md5sums:28 dh_movefiles:32 dh_perl:31 dh_python:39 dh_scrollkeeper:32 dh_shlibdeps:26 dh_strip:35 dh_testdir:23 dh_testversion:34 dh_usrlocal:39
+#: dh_builddeb:21 dh_clean:28 dh_compress:38 dh_fixperms:31 dh_gconf:34 dh_gencontrol:26 dh_installcatalogs:44 dh_installchangelogs:40 dh_installcron:24 dh_installdebconf:50 dh_installdirs:28 dh_installdocs:51 dh_installemacsen:35 dh_installexamples:29 dh_installinfo:37 dh_installinit:33 dh_installlogrotate:22 dh_installmanpages:40 dh_installman:58 dh_installmenu:34 dh_installmime:31 dh_installmodules:39 dh_installpam:24 dh_install:47 dh_installppp:26 dh_installwm:32 dh_link:48 dh_makeshlibs:28 dh_md5sums:28 dh_movefiles:32 dh_perl:31 dh_python:39 dh_scrollkeeper:32 dh_shlibdeps:26 dh_strip:35 dh_testdir:23 dh_testversion:34 dh_usrlocal:39
 msgid "OPTIONS"
 msgstr ""
 
@@ -962,12 +986,12 @@ msgid "Pass I<params> to L<dpkg-deb(1)> when it is used to build the package."
 msgstr ""
 
 # type: textblock
-#: dh_builddeb:87 dh_clean:108 dh_compress:191 dh_fixperms:112 dh_gconf:92 dh_gencontrol:75 dh_installcatalogs:113 dh_installchangelogs:127 dh_installcron:63 dh_installdebconf:120 dh_installdeb:96 dh_installdirs:85 dh_installdocs:239 dh_installemacsen:111 dh_installexamples:105 dh_installinfo:105 dh_installinit:199 dh_installlogcheck:53 dh_installlogrotate:52 dh_installmanpages:199 dh_installman:248 dh_installmime:87 dh_installmodules:118 dh_installpam:54 dh_install:253 dh_installppp:58 dh_installwm:109 dh_installxfonts:88 dh_link:225 dh_listpackages:30 dh_makeshlibs:224 dh_md5sums:88 dh_movefiles:164 dh_perl:154 dh_python:284 dh_strip:226 dh_suidregister:119 dh_testdir:45 dh_testroot:28 dh_testversion:76 dh_undocumented:30 dh_usrlocal:116
+#: dh_builddeb:87 dh_clean:111 dh_compress:191 dh_fixperms:112 dh_gconf:92 dh_gencontrol:75 dh_installcatalogs:113 dh_installchangelogs:127 dh_installcron:63 dh_installdebconf:120 dh_installdeb:96 dh_installdirs:85 dh_installdocs:239 dh_installemacsen:111 dh_installexamples:105 dh_installinfo:105 dh_installinit:199 dh_installlogcheck:53 dh_installlogrotate:52 dh_installmanpages:199 dh_installman:251 dh_installmime:87 dh_installmodules:118 dh_installpam:54 dh_install:270 dh_installppp:58 dh_installwm:109 dh_installxfonts:88 dh_link:225 dh_listpackages:30 dh_makeshlibs:224 dh_md5sums:88 dh_movefiles:164 dh_perl:154 dh_python:284 dh_strip:226 dh_suidregister:119 dh_testdir:45 dh_testroot:28 dh_testversion:76 dh_undocumented:30 dh_usrlocal:116
 msgid "L<debhelper(7)>"
 msgstr ""
 
 # type: textblock
-#: dh_builddeb:89 dh_clean:110 dh_compress:193 dh_desktop:51 dh_fixperms:114 dh_gconf:94 dh_gencontrol:77 dh_installchangelogs:129 dh_installcron:65 dh_installdebconf:122 dh_installdeb:98 dh_installdirs:87 dh_installdocs:241 dh_installemacsen:113 dh_installexamples:107 dh_installinfo:107 dh_installinit:201 dh_installlogrotate:54 dh_installmanpages:201 dh_installman:250 dh_installmenu:86 dh_installmime:89 dh_installmodules:120 dh_installpam:56 dh_install:255 dh_installppp:60 dh_installwm:111 dh_installxfonts:90 dh_link:227 dh_listpackages:32 dh_makeshlibs:226 dh_md5sums:90 dh_movefiles:166 dh_perl:156 dh_python:286 dh_scrollkeeper:80 dh_shlibdeps:163 dh_strip:228 dh_suidregister:121 dh_testdir:47 dh_testroot:30 dh_testversion:78 dh_undocumented:32 dh_usrlocal:118
+#: dh_builddeb:89 dh_clean:113 dh_compress:193 dh_desktop:51 dh_fixperms:114 dh_gconf:94 dh_gencontrol:77 dh_installchangelogs:129 dh_installcron:65 dh_installdebconf:122 dh_installdeb:98 dh_installdirs:87 dh_installdocs:241 dh_installemacsen:113 dh_installexamples:107 dh_installinfo:107 dh_installinit:201 dh_installlogrotate:54 dh_installmanpages:201 dh_installman:253 dh_installmenu:86 dh_installmime:89 dh_installmodules:120 dh_installpam:56 dh_install:272 dh_installppp:60 dh_installwm:111 dh_installxfonts:90 dh_link:227 dh_listpackages:32 dh_makeshlibs:226 dh_md5sums:90 dh_movefiles:166 dh_perl:156 dh_python:286 dh_scrollkeeper:80 dh_shlibdeps:163 dh_strip:228 dh_suidregister:121 dh_testdir:47 dh_testroot:30 dh_testversion:78 dh_undocumented:32 dh_usrlocal:118
 msgid "This program is a part of debhelper."
 msgstr ""
 
@@ -995,17 +1019,24 @@ msgid ""
 "debhelper commands. It also removes common files that should not appear in "
 "a\n"
 "debian diff:\n"
-"  #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS core .deps/* *.P\n"
+"  #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS .deps/* *.P\n"
 "\n"
 msgstr ""
 
+# type: textblock
+#: dh_clean:25
+msgid ""
+"It does not run \"make clean\" to clean up after the build process. Use "
+"L<dh_auto_clean(1)> to do that."
+msgstr ""
+
 # type: =item
-#: dh_clean:29 dh_installchangelogs:44
+#: dh_clean:32 dh_installchangelogs:44
 msgid "B<-k>, B<--keep>"
 msgstr ""
 
 # type: textblock
-#: dh_clean:31
+#: dh_clean:34
 msgid ""
 "Do not delete debian/files. When do you want to use this? Anytime you have a "
 "debian/rules that has 2 binary targets that build different .deb packages; "
@@ -1017,24 +1048,24 @@ msgid ""
 msgstr ""
 
 # type: =item
-#: dh_clean:39
+#: dh_clean:42
 msgid "B<-d>, B<--dirs-only>"
 msgstr ""
 
 # type: textblock
-#: dh_clean:41
+#: dh_clean:44
 msgid ""
 "Only clean the package build directories, do not clean up any other files at "
 "all."
 msgstr ""
 
 # type: =item
-#: dh_clean:44
+#: dh_clean:47
 msgid "B<-X>I<item> B<--exclude=>I<item>"
 msgstr ""
 
 # type: textblock
-#: dh_clean:46
+#: dh_clean:49
 msgid ""
 "Exclude files that contain \"item\" anywhere in their filename from being "
 "deleted, even if they would normally be deleted. You may use this option "
@@ -1042,12 +1073,12 @@ msgid ""
 msgstr ""
 
 # type: =item
-#: dh_clean:50 dh_compress:55 dh_installdocs:69 dh_installexamples:38 dh_installinfo:50 dh_installmanpages:44 dh_movefiles:49 dh_testdir:27
+#: dh_clean:53 dh_compress:55 dh_installdocs:69 dh_installexamples:38 dh_installinfo:50 dh_installmanpages:44 dh_movefiles:49 dh_testdir:27
 msgid "I<file ...>"
 msgstr ""
 
 # type: textblock
-#: dh_clean:52
+#: dh_clean:55
 msgid "Delete these files too."
 msgstr ""
 
@@ -1755,7 +1786,7 @@ msgid "Do not modify postinst/prerm scripts."
 msgstr ""
 
 # type: =item
-#: dh_installdocs:64 dh_installexamples:43 dh_install:47 dh_link:57 dh_movefiles:44
+#: dh_installdocs:64 dh_installexamples:43 dh_install:51 dh_link:57 dh_movefiles:44
 msgid "B<-Xitem>, B<--exclude=item>"
 msgstr ""
 
@@ -1922,7 +1953,7 @@ msgid ""
 msgstr ""
 
 # type: textblock
-#: dh_installexamples:45 dh_install:49 dh_movefiles:46
+#: dh_installexamples:45 dh_install:53 dh_movefiles:46
 msgid ""
 "Exclude files that contain \"item\" anywhere in their filename from being "
 "installed."
@@ -2622,13 +2653,21 @@ msgid ""
 "directories and files from there into the proper package build directories."
 msgstr ""
 
+# type: textblock
+#: dh_install:43
+msgid ""
+"From debhelper compatability level 7 on, if --sourcedir is not specified, "
+"dh_install will install files from debian/tmp if the directory contains the "
+"files. Otherwise, it will install files from the current directory."
+msgstr ""
+
 # type: =item
-#: dh_install:52
+#: dh_install:56
 msgid "B<--autodest>"
 msgstr ""
 
 # type: textblock
-#: dh_install:54
+#: dh_install:58
 msgid ""
 "Guess as the destination directory to install things to. If this is "
 "specified, you should not list destination directories in "
@@ -2637,7 +2676,7 @@ msgid ""
 msgstr ""
 
 # type: textblock
-#: dh_install:59
+#: dh_install:63
 msgid ""
 "Strip off debian/tmp (or the sourcedir if one is given) from the front of "
 "the filename, if it is present, and install into the dirname of the "
@@ -2647,7 +2686,7 @@ msgid ""
 msgstr ""
 
 # type: textblock
-#: dh_install:65
+#: dh_install:69
 msgid ""
 "Note that if you list exactly one filename or wildcard-pattern on a line by "
 "itself in a debian/package.install file, with no explicit destination, then "
@@ -2656,12 +2695,12 @@ msgid ""
 msgstr ""
 
 # type: =item
-#: dh_install:70
+#: dh_install:74
 msgid "B<--list-missing>"
 msgstr ""
 
 # type: textblock
-#: dh_install:72
+#: dh_install:76
 msgid ""
 "This option makes dh_install keep track of the files it installs, and then "
 "at the end, compare that list with the files in the source directory. If any "
@@ -2670,45 +2709,45 @@ msgid ""
 msgstr ""
 
 # type: textblock
-#: dh_install:77
+#: dh_install:81
 msgid ""
 "This may be useful if you have a large package and want to make sure that "
 "you don't miss installing newly added files in new upstream releases."
 msgstr ""
 
 # type: textblock
-#: dh_install:80
+#: dh_install:84
 msgid ""
 "Note that files that are excluded from being moved via the -X option are not "
 "warned about."
 msgstr ""
 
 # type: =item
-#: dh_install:83
+#: dh_install:87
 msgid "B<--fail-missing>"
 msgstr ""
 
 # type: textblock
-#: dh_install:85
+#: dh_install:89
 msgid ""
 "This option is like --list-missing, except if a file was missed, it will not "
 "only list the missing files, but also fail with a nonzero exit code."
 msgstr ""
 
 # type: =item
-#: dh_install:88
+#: dh_install:92
 msgid "B<--sourcedir=dir>"
 msgstr ""
 
 # type: textblock
-#: dh_install:90
+#: dh_install:94
 msgid ""
 "Makes all source files be found under dir. If this is specified, it is akin "
 "to all the source filenames having \"dir/\" prepended to them."
 msgstr ""
 
 # type: textblock
-#: dh_install:93
+#: dh_install:97
 msgid ""
 "To make dh_install behave like the old dh_movefiles, move your package.files "
 "file to package.install and call dh_install with \"--sourcedir=debian/tmp\" "
@@ -2717,24 +2756,24 @@ msgid ""
 msgstr ""
 
 # type: =item
-#: dh_install:99
+#: dh_install:103
 msgid "I<file [...] dest>"
 msgstr ""
 
 # type: textblock
-#: dh_install:101
+#: dh_install:105
 msgid ""
 "Lists files (or directories) to install and where to install them to.  The "
 "files will be installed into the first package dh_install acts on."
 msgstr ""
 
 # type: =head1
-#: dh_install:224
+#: dh_install:241
 msgid "EXAMPLE"
 msgstr ""
 
 # type: textblock
-#: dh_install:226
+#: dh_install:243
 msgid ""
 "Suppose your package's upstream Makefile installs a binary, a man page, and "
 "a library into appropriate subdirectories of debian/tmp. You want to put the "
@@ -2744,7 +2783,7 @@ msgid ""
 msgstr ""
 
 # type: verbatim
-#: dh_install:232
+#: dh_install:249
 #, no-wrap
 msgid ""
 "  usr/bin\n"
@@ -2753,12 +2792,12 @@ msgid ""
 msgstr ""
 
 # type: textblock
-#: dh_install:235
+#: dh_install:252
 msgid "While debian/libfoo.install contains:"
 msgstr ""
 
 # type: verbatim
-#: dh_install:237
+#: dh_install:254
 #, no-wrap
 msgid ""
 "  usr/lib/libfoo*.so.*\n"
@@ -2766,14 +2805,14 @@ msgid ""
 msgstr ""
 
 # type: textblock
-#: dh_install:239
+#: dh_install:256
 msgid ""
 "If you want a libfoo-dev package too, debian/libfoo-dev.install might "
 "contain:"
 msgstr ""
 
 # type: verbatim
-#: dh_install:241
+#: dh_install:258
 #, no-wrap
 msgid ""
 "  usr/include\n"
@@ -2783,12 +2822,12 @@ msgid ""
 msgstr ""
 
 # type: =head1
-#: dh_install:245
+#: dh_install:262
 msgid "LIMITATIONS"
 msgstr ""
 
 # type: verbatim
-#: dh_install:247
+#: dh_install:264
 #, no-wrap
 msgid ""
 "dh_install cannot rename files or directories, it can only install them\n"