]> git.donarmstrong.com Git - debhelper.git/blob - dh_clean.1
5db26de0e01bc486da90adc4c14379bae755e5d0
[debhelper.git] / dh_clean.1
1 .TH DH_CLEAN 1 "" "Debhelper Commands" "Debhelper Commands"
2 .SH NAME
3 dh_clean \- clean up package build directories
4 .SH SYNOPSIS
5 .B dh_clean
6 .I "[debhelper options] [-k] [-d] [file ...] [-Xitem]"
7 .SH "DESCRIPTION"
8 dh_clean is a debhelper program that is responsible for cleaning up after a
9 package is built. It removes the package build directories, and removes some
10 other files, such as debian/substvars, debian/files, and any detritus left
11 behind by other debhelper commands. It also removes common files that
12 should not appear in a debian diff:
13   #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS core .deps/* *.P
14 .SH OPTIONS
15 .TP
16 .B debhelper options
17 See
18 .BR debhelper (1)
19 for a list of options common to all debhelper commands.
20 .TP
21 .B \-k, \--keep
22 Do not delete debian/files. When do you want to use this? Anytime you have a
23 debian/rules that has 2 binary targets that build different .deb packages;
24 for example, one target is binary-arch, and the other is binary-indep, or
25 one target builds the shared library, and the other the -dev package. If you
26 didn't use -k in these cases, then debian/files would be deleted in the
27 middle, and your changes file will only contain the last binary package that
28 was built.
29 .TP
30 .B \-d, \--dirs-only
31 Only clean the package build directories, do not clean up any other files at
32 all.
33 .TP
34 .B \-Xitem, \--exclude=item
35 Exclude files that contain "item" anywhere in their filename from being
36 deleted, even if they would normally be deleted. You may use this option
37 multiple times to build up a list of things to exclude.
38 .TP
39 .B file ...
40 Delete these files too.
41 .SH ENVIRONMENT
42 See
43 .BR debhelper (1)
44 for a list of environment variables that affect all debhelper commands.
45 .SH "SEE ALSO"
46 .BR debhelper (1)
47 .SH AUTHOR
48 Joey Hess <joeyh@debian.org>