5 dh_clean - clean up package build directories
10 use Debian::Debhelper::Dh_Lib;
14 B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] [S<I<file ...>>]
18 dh_clean is a debhelper program that is responsible for cleaning up after a
19 package is built. It removes the package build directories, and removes some
20 other files including debian/files, and any detritus left behind by other
21 debhelper commands. It also removes common files that should not appear in a
23 #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS .deps/* *.P
25 It does not run "make clean" to clean up after the build process. Use
26 L<dh_auto_clean(1)> to do that.
28 The debian/clean file can list other files to be removed.
34 =item B<-k>, B<--keep>
36 Do not delete debian/files. When do you want to use this? Anytime you have a
37 debian/rules that has 2 binary targets that build different .deb packages;
38 for example, one target is binary-arch, and the other is binary-indep, or
39 one target builds the shared library, and the other the -dev package. If you
40 didn't use -k in these cases, then debian/files would be deleted in the
41 middle, and your changes file will only contain the last binary package that
44 =item B<-d>, B<--dirs-only>
46 Only clean the package build directories, do not clean up any other files
49 =item B<-X>I<item> B<--exclude=>I<item>
51 Exclude files that contain "item" anywhere in their filename from being
52 deleted, even if they would normally be deleted. You may use this option
53 multiple times to build up a list of things to exclude.
57 Delete these files too.
65 foreach my $package (@{$dh{DOPACKAGES}}) {
66 my $tmp=tmpdir($package);
67 my $ext=pkgext($package);
70 doit("rm","-f","debian/${ext}substvars")
71 unless excludefile("debian/${ext}substvars");
73 # These are all debhelper temp files, and so it is safe to
75 complex_doit("rm -f debian/$ext*.debhelper");
78 doit ("rm","-rf",$tmp."/")
79 unless excludefile($tmp);
84 doit("rm","-f","--",@ARGV);
87 if (!compat(6) && -e "debian/clean") {
88 my @clean=grep { ! excludefile($_) }
89 filearray("debian/clean", ".");
90 doit("rm","-f","--",@clean) if @clean;
94 doit("rm","-f","debian/files")
95 unless excludefile("debian/files");
98 # See if some files that would normally be deleted are excluded.
100 if (defined($dh{EXCLUDE_FIND}) && $dh{EXCLUDE_FIND} ne '') {
101 $find_options="! \\( $dh{EXCLUDE_FIND} \\) -a";
104 # Remove other temp files.
105 complex_doit("find . $find_options \\( \\( -type f -a \\
106 \\( -name '#*#' -o -name '.*~' -o -name '*~' -o -name DEADJOE \\
107 -o -name '*.orig' -o -name '*.rej' -o -name '*.bak' \\
108 -o -name '.*.orig' -o -name .*.rej -o -name '.SUMS' \\
109 -o -name TAGS -o \\( -path '*/.deps/*' -a -name '*.P' \\) \\
110 \\) -exec rm -f {} \\; \\) -o \\
111 \\( -type d -a -name autom4te.cache -prune -exec rm -rf {} \\; \\) \\)");
114 doit('rm', '-rf', 'debian/tmp') if -x 'debian/tmp' && ! compat(1) &&
115 ! excludefile("debian/tmp");
121 This program is a part of debhelper.
125 Joey Hess <joeyh@debian.org>