Browsing English (Canada) translation

1232.

On Debian systems, the complete text of the GNU General Public License can be found in I</usr/share/common-licenses/GPL>.

1233.

Reporting bugs

1234.

The program is part of the devscripts package. Please report bugs using `B<reportbug devscripts>`

1235.

DEBUILD

1236.

debuild - build a Debian package

1237.

B<debuild> [I<debuild options>] [I<dpkg-buildpackage options>] [B<--lintian-opts> I<lintian options>]

1238.

B<debuild> [I<debuild options>] B<binary>|B<binary-arch>|B<binary-indep>|B<clean> ...

1239.

B<debuild> creates all the files necessary for uploading a Debian package. It first runs B<dpkg-buildpackage>, then runs B<lintian> on the I<.changes> file created (assuming that B<lintian> is installed), and finally signs the I<.changes> and/or I<.dsc> files as appropriate (using B<debsign>(1) to do this instead of B<dpkg-buildpackage>(1) itself; all relevant key-signing options are passed on). Parameters can be passed to B<dpkg-buildpackage> and B<lintian>, where the parameters to the latter are indicated with the B<--lintian-opts> option. The allowable options in this case are B<--lintian> and B<--no-lintian> to force or skip the B<lintian> step, respectively. The default is to run B<lintian>. There are also various options available for setting and preserving environment variables, as described below in the Environment Variables section. In this method of running B<debuild>, we also save a build log to the file I<../E<lt>packageE<gt>_E<lt>versionE<gt>_E<lt>archE<gt>.build>.

1240.

An alternative way of using B<debuild> is to use one or more of the parameters B<binary>, B<binary-arch>, B<binary-indep> and B<clean>, in which case B<debuild> will attempt to gain root privileges and then run I<debian/rules> with the given parameters. A B<--rootcmd=>I<gain-root-command> or B<-r>I<gain-root-command> option may be used to specify a method of gaining root privileges. The I<gain-root-command> is likely to be one of I<fakeroot>, I<sudo> or I<super>. See below for further discussion of this point. Again, the environment preservation options may be used. In this case, B<debuild> will also attempt to run B<dpkg-checkbuilddeps> first; this can be explicitly requested or switched off using the options B<-D> and B<-d> respectively. Note also that if either of these or a B<-r> option is specified in the configuration file option B<DEBUILD_DPKG_BUILDPACKAGE_OPTS>, then it will be recognised even in this method of invocation of B<debuild>.

1241.

B<debuild> also reads the B<devscripts> configuration files as described below. This allows default options to be given.