/usr/bin/dh_clean is in debhelper 10.2.5.
This file is owned by root:root, with mode 0o755.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 | #!/usr/bin/perl
=head1 NAME
dh_clean - clean up package build directories
=cut
use strict;
use warnings;
use Debian::Debhelper::Dh_Lib;
=head1 SYNOPSIS
B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] [S<I<path> ...>]
=head1 DESCRIPTION
B<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 including F<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
It does not run "make clean" to clean up after the build process. Use
L<dh_auto_clean(1)> to do things like that.
B<dh_clean> should be the last debhelper command run in the
B<clean> target in F<debian/rules>.
=head1 FILES
=over 4
=item F<debian/clean>
Can list other paths to be removed.
Note that directories listed in this file B<must> end with a trailing
slash. Any content in these directories will be removed as well.
=back
=head1 OPTIONS
=over 4
=item B<-k>, B<--keep>
This is deprecated, use L<dh_prep(1)> instead.
The option is removed in compat 11.
=item B<-d>, B<--dirs-only>
Only clean the package build directories, do not clean up any other files
at all.
=item B<-X>I<item> B<--exclude=>I<item>
Exclude files that contain I<item> anywhere in their filename from being
deleted, even if they would normally be deleted. You may use this option
multiple times to build up a list of things to exclude.
=item I<path> ...
Delete these I<path>s too.
Note that directories passed as arguments B<must> end with a trailing
slash. Any content in these directories will be removed as well.
=back
=cut
init(options => {
"dirs-only" => \$dh{D_FLAG},
});
inhibit_log();
if ($dh{K_FLAG}) {
# dh_prep will be emulated (mostly) by the code below.
if (not compat(10)) {
error("The -k option is not supported in compat 11; use dh_prep instead");
}
warning("dh_clean -k is deprecated; use dh_prep instead");
}
# Remove the debhelper stamp file
doit('rm', '-f', 'debian/debhelper-build-stamp') if not $dh{D_FLAG};
foreach my $package (@{$dh{DOPACKAGES}}) {
my $tmp=tmpdir($package);
my $ext=pkgext($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");
}
doit ("rm","-rf",$tmp."/")
unless excludefile($tmp);
}
if (not $dh{D_FLAG}) {
# Restore all files in our bucket (before we delete said bucket)
restore_all_files();
# Remove internal state data
doit('rm', '-rf', 'debian/.debhelper/');
}
# Remove all debhelper logs.
if (! $dh{D_FLAG} && ! $dh{K_FLAG}) {
complex_doit("rm","-f","debian/*.debhelper.log");
}
if (! $dh{D_FLAG}) {
my (@clean_files, @clean_dirs);
if (@ARGV) {
push(@clean_files, grep { !m@/$@ } @ARGV);
push(@clean_dirs, grep { m@/$@ } @ARGV);
}
if (! $dh{K_FLAG}) {
if (!compat(6) && -e "debian/clean") {
my @clean=grep { ! excludefile($_) }
filearray("debian/clean", ".");
push(@clean_files, grep { !m@/$@ } @clean);
push(@clean_dirs, grep { m@/$@ } @clean);
}
doit("rm","-f","debian/files")
unless excludefile("debian/files");
}
doit('rm', '-f', '--', @clean_files) if @clean_files;
doit('rm', '-fr', '--', @clean_dirs) if @clean_dirs;
# 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="! \\( $dh{EXCLUDE_FIND} \\) -a";
}
# vcs directories that should not have their contents cleaned
my $vcs_dirs=join " -o ", map { "-path .\\*/" . $_ }
(".git", ".svn", ".bzr", ".hg", "CVS");
# Remove other temp files.
complex_doit("find . $find_options \\( \\( \\
\\( $vcs_dirs \\) -prune -o -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' &&
! excludefile("debian/tmp");
if (!compat(6) && !$dh{K_FLAG}) {
complex_doit('rm -f *-stamp');
}
=head1 SEE ALSO
L<debhelper(7)>
This program is a part of debhelper.
=head1 AUTHOR
Joey Hess <joeyh@debian.org>
=cut
# Local Variables:
# indent-tabs-mode: t
# tab-width: 4
# cperl-indent-level: 4
# End:
|