[debhelper-devel] [debhelper] 02/03: dh_install: Push some documentation to dh_missing(1)

[Niels Thykier]

This is an automated email from the git hooks/post-receive script.

nthykier pushed a commit to branch master
in repository debhelper.

commit 78b9f2459decda2e360dd904065c438f1a661106
Author: Niels Thykier <niels at thykier.net>
Date:   Sat Dec 30 09:50:42 2017 +0000

    dh_install: Push some documentation to dh_missing(1)
    
    Signed-off-by: Niels Thykier <niels at thykier.net>
---
 dh_install | 39 ++++++++++++---------------------------
 1 file changed, 12 insertions(+), 27 deletions(-)

diff --git a/dh_install b/dh_install
index 05bcf76..b647ed7 100755
--- a/dh_install
+++ b/dh_install
@@ -58,14 +58,8 @@ will automatically guess the destination to use, the same as if the
 
 =item debian/not-installed
 
-List the files that are deliberately not installed in I<any> binary
-package.  Paths listed in this file are (I<only>) ignored by the check
-done via B<--list-missing> (or B<--fail-missing>).  However, it is
-B<not> a method to exclude files from being installed.  Please use
-B<--exclude> for that.
-
-Please keep in mind that dh_install will B<not> expand wildcards in
-this file.
+Used with the deprecated B<--list-missing> and B<--fail-missing> options.
+Please refer to L<dh_missing(1)> for the documentation of this file.
 
 =back
 
@@ -75,30 +69,21 @@ this file.
 
 =item B<--list-missing>
 
-B<Deprecated>: Please use B<dh_missing --list-missing> instead.
-
-This option makes B<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 of
-the files (and symlinks) in the source directory were not installed to
-somewhere, it will warn on stderr about that.
-
-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.
+B<Deprecated>: Please use B<dh_missing --list-missing> instead.  If you use
+this option, B<dh_install> will call B<dh_missing> with that option after it has
+processed all the files.  Please see L<dh_missing(1)> for the documentation of
+this option.
 
-Note that files that are excluded from being moved via the B<-X> option are not
-warned about.
+This option is removed in compat 12.
 
 =item B<--fail-missing>
 
-B<Deprecated>: Please use B<dh_missing --fail-missing> instead.
-
-This option is like B<--list-missing>, except if a file was missed, it will
-not only list the missing files, but also fail with a nonzero exit code. 
-
-=item B<-X>I<item>, B<--exclude=>I<item>
+B<Deprecated>: Please use B<dh_missing --fail-missing> instead.  If you use
+this option, B<dh_install> will call B<dh_missing> with that option after it has
+processed all the files.  Please see L<dh_missing(1)> for the documentation of
+this option.
 
-Exclude files that contain I<item> anywhere in their filename from
-being installed.
+This option is removed in compat 12.
 
 =item B<--sourcedir=>I<dir>
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debhelper/debhelper.git