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 (debian/*.debhelper). 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 *-stamp
+
+The debian/clean file can list other files to be removed.
+
+It does not run "make clean" to clean up after the build process. Use
+L<dh_auto_clean(1)> to do that.
+
+dh_clean (or "dh clean") should be the last debhelper command run in the
+clean target in debian/rules.
=head1 OPTIONS
=item B<-k>, B<--keep>
-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;
-for example, one target is binary-arch, and the other is binary-indep, or
-one target builds the shared library, and the other the -dev package. If you
-didn't use -k in these cases, then debian/files would be deleted in the
-middle, and your changes file will only contain the last binary package that
-was built.
+This is deprecated, use L<dh_prep(1)> instead.
=item B<-d>, B<--dirs-only>
=cut
-init();
+init(options => {
+ "dirs-only" => \$dh{D_FLAG},
+});
+inhibit_log();
+
+if ($dh{K_FLAG}) {
+ # dh_prep will be emulated (mostly) by the code below.
+ # TODO deprecation warning
+}
foreach my $package (@{$dh{DOPACKAGES}}) {
my $tmp=tmpdir($package);
if (! $dh{D_FLAG}) {
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");
+
+ if (! $dh{K_FLAG}) {
+ doit("rm","-f","debian/${ext}debhelper.log");
+ }
}
- doit ("rm","-rf",$tmp)
+ doit ("rm","-rf",$tmp."/")
unless excludefile($tmp);
}
}
if (! $dh{K_FLAG}) {
+ if (!compat(6) && -e "debian/clean") {
+ my @clean=grep { ! excludefile($_) }
+ filearray("debian/clean", ".");
+ doit("rm","-f","--",@clean) if @clean;
+ }
+
doit("rm","-f","debian/files")
unless excludefile("debian/files");
}
- # These are all debhelper temp files, and so it is safe to
- # wildcard them.
- complex_doit("rm -f debian/*.debhelper");
-
- # Remove some files that were left around by older versions of
- # debhelper.
- doit("rm","-f","debian/substvars");
-
# 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 *~ -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 {} ;"));
-
- # Stupid autoconf cache directory.
- doit("rm", "-rf", "autom4te.cache")
- unless excludefile("autom4te.cache");
+ 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");
+
+if (!compat(6) && !$dh{K_FLAG}) {
+ complex_doit('rm -f *-stamp');
+}
=head1 SEE ALSO
-L<debhelper(1)>
+L<debhelper(7)>
This program is a part of debhelper.