blob: 0e03cc3e8cb40882fcebe6510e42bb11d8da79ba (
plain)
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
|
# dpkg manual page - dpkg-buildtree(1)
#
# Copyright © 2023 Guillem Jover <guillem@debian.org>
#
# This is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <https://www.gnu.org/licenses/>.
=encoding utf8
=head1 NAME
dpkg-buildtree - helper for build tree operations during package builds
=head1 SYNOPSIS
B<dpkg-buildtree> [I<option>...] [I<command>]
=head1 DESCRIPTION
B<dpkg-buildtree> is a tool to perform common operations on the build tree
for a source package.
This program was introduced in dpkg 1.22.3.
=head1 COMMANDS
=over
=item B<clean>
Removes all artifacts generated during a build by the various dpkg tools,
and pathnames used or controlled by dpkg tools that are safe to clean.
These files are used to track state between package build runs,
and are in many cases internal implementation details the packager should
not be concerned about,
or are staging directories containing build artifacts.
=item B<--help>
Show the usage message and exit.
=item B<--version>
Show the version and exit.
=back
=head1 ENVIRONMENT
=over
=item B<DPKG_COLORS>
Sets the color mode.
The currently accepted values are: B<auto> (default), B<always> and
B<never>.
=item B<DPKG_NLS>
If set, it will be used to decide whether to activate Native Language Support,
also known as internationalization (or i18n) support.
The accepted values are: B<0> and B<1> (default).
=back
=head1 FILES
=head2 Cleaned files
=over
=item F<debian/files>
=item F<debian/files.new>
Files generated by L<dpkg-distaddfile(1)>.
=item F<debian/substvars>
=item F<debian/substvars.new>
Files generated by L<dpkg-shlibdeps(1)>.
=item F<debian/tmp>
Staging directory containing the contents to be used when creating a package.
Both L<dpkg-gencontrol(1)> and L<dpkg-gensymbols(1)> generate files within.
=back
=head1 EXAMPLES
=head2 Usage in debian/rules
You can call B<dpkg-buildtree clean> from the F<debian/rules> B<clean> target,
after having performed other necessary cleanups.
For example for an autoconf-like build system:
=over
clean:
[ ! -f Makefile ] || $(MAKE) distclean
dpkg-buildtree clean
=back
|
