dh_clean: In v7 mode, read debian/clean and delete all files listed therein.

[debhelper.git] / dh_clean

diff --git a/dh_clean b/dh_clean
index 341d1fbf6b6c140b82da5d8aaa886eb283e9a458..96b8113a8f1e9ca13ae465d0fe3b24fb386e2c9f 100755 (executable)
--- a/dh_clean
+++ b/dh_clean
@@ -11,16 +11,21 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_clean [debhelper options] [-k] [-d] [file ...] [-Xitem]
+B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] [S<I<file ...>>]
 
 =head1 DESCRIPTION
 
 dh_clean is a debhelper program that is responsible for cleaning up after a
 package is built. It removes the package build directories, and removes some
-other files, such as debian/substvars, debian/files, and any detritus left
-behind by other debhelper commands. It also removes common files that
-should not appear in a debian diff:
-  #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS core .deps/* *.P
+other files including debian/files, and any detritus left behind by other
+debhelper commands. It also removes common files that should not appear in a
+debian diff:
+  #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS .deps/* *.P
+
+It does not run "make clean" to clean up after the build process. Use
+L<dh_auto_clean(1)> to do that.
+
+The debian/clean file can list other files to be removed.
 
 =head1 OPTIONS
 
@@ -62,48 +67,56 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
        my $ext=pkgext($package);
 
        if (! $dh{D_FLAG}) {
-               doit("rm","-f","debian/${ext}substvars",
-                       "debian/${ext}postinst.debhelper",
-                       "debian/${ext}postrm.debhelper",
-                       "debian/${ext}preinst.debhelper",
-                       "debian/${ext}prerm.debhelper");
+               doit("rm","-f","debian/${ext}substvars")
+                       unless excludefile("debian/${ext}substvars");
+               
+               # These are all debhelper temp files, and so it is safe to 
+               # wildcard them.
+               complex_doit("rm -f debian/$ext*.debhelper");
        }
        
-       doit ("rm","-rf",$tmp);
+       doit ("rm","-rf",$tmp."/")
+               unless excludefile($tmp);
 }
 
 if (! $dh{D_FLAG}) {
        if (@ARGV) {
                doit("rm","-f","--",@ARGV);
        }
+       
+       if (!compat(6) && -e "debian/clean") {
+               my @clean=grep { ! excludefile($_) }
+                       filearray("debian/clean", ".");
+               doit("rm","-f","--",@clean) if @clean;
+       }
 
        if (! $dh{K_FLAG}) {
-               doit("rm","-f","debian/files");
+               doit("rm","-f","debian/files")
+                       unless excludefile("debian/files");
        }
 
        # See if some files that would normally be deleted are excluded.
        my $find_options='';
        if (defined($dh{EXCLUDE_FIND}) && $dh{EXCLUDE_FIND} ne '') {
-               $find_options="-a ! ( $dh{EXCLUDE_FIND} )";
+               $find_options="! \\( $dh{EXCLUDE_FIND} \\) -a";
        }
 
        # Remove other temp files.
-       # (The \s+ is important, \s won't work because find would get null
-       # parameters). Note that you _don't_ quote wildcards used by find
-       # in here.
-       doit(split(/\s+/,"find . -type f -a
-               ( -name #*# -o -name *~ -o -name DEADJOE
-                -o -name *.orig -o -name *.rej -o -name *.bak
-                -o -name .*.orig -o -name .*.rej -o -name .SUMS
-                -o -name TAGS -o -name core -o ( -path */.deps/* -a -name *.P )
-               ) $find_options -exec rm -f {} ;"));
+       complex_doit("find . $find_options \\( \\( -type f -a \\
+               \\( -name '#*#' -o -name '.*~' -o -name '*~' -o -name DEADJOE \\
+                -o -name '*.orig' -o -name '*.rej' -o -name '*.bak' \\
+                -o -name '.*.orig' -o -name .*.rej -o -name '.SUMS' \\
+                -o -name TAGS -o \\( -path '*/.deps/*' -a -name '*.P' \\) \\
+               \\) -exec rm -f {} \\; \\) -o \\
+               \\( -type d -a -name autom4te.cache -prune -exec rm -rf {} \\; \\) \\)");
 }
 
-doit('rm', '-rf', 'debian/tmp') if -x 'debian/tmp' && ! compat(1);
+doit('rm', '-rf', 'debian/tmp') if -x 'debian/tmp' && ! compat(1) &&
+                                   ! excludefile("debian/tmp");
 
 =head1 SEE ALSO
 
-L<debhelper(1)>
+L<debhelper(7)>
 
 This program is a part of debhelper.