devscripts - scripts to ease the lives of Debian developers
DESCRIPTION
The devscripts package provides a collection of scripts which
may be of use to Debian developers and others wishing to build Debian
packages. The following gives a summary of the available scripts --
please read the individual manpages for full details about the use of
these scripts. They are contributed by multiple developers; for
details of the authors, please see the code or manpages.
debuild
A wrapper for dpkg-buildpackage to avoid problems with
insufficient permissions and wrong paths etc. debuild will set
up the proper environment for building a package. debuild will
use the fakeroot program to build the package by default, but
can be instructed to use any other gain-root command, or can even be
installed setuid root. debuild can also be used to run various
of the debian/rules operations with the same root-gaining
procedure. debuild will also run lintian to check that
the package does not have any major policy violations.
debsign
Use gpg (the GNU Privacy Guard) to sign the .changes
and .dsc files created by running dpkg-buildpackage with
no-sign options. Useful if you are building a package on a remote
machine and wish to sign it on a local one. This script is capable of
automatically downloading the .changes and .dsc files from
a remote machine.
debrsign
This transfers a .changes/.dsc pair to a remote machine
for signing, and runs debsign on the remote machine over an SSH
connection.
debrelease
A wrapper around dupload or dput which figures out which
version to upload, and then calls dupload or dput to
actually perform the upload.
debchange, dch
Modifies debian/changelog and manages version numbers for you.
It will either increment the version number or add an entry for the
current version, depending upon the options given to it.
dpkg-depcheck, dpkg-genbuilddeps
Runs a specified command (such as debian/rules build) or
dpkg-buildpackage, respectively, to determine the packages used
during the build process. This information can be helpful when trying
to determine the packages needed in the Build-Depends etc. lines in
the debian/control file.
debpkg
A wrapper for dpkg used by debi to allow convenient
testing of packages. For debpkg to work, it needs to be made
setuid root. For more details of this, please see the debpkg
manpage.
debdiff
A program which examines two .deb files or two .changes
files and reports on any difference found in their file lists. Useful
for ensuring that no files were inadvertantly lost between versions.
debi
Installs the current package by using the setuid root debpkg
script described above. It assumes that the current package has just
been built (for example by debuild), and the .deb lives in
the parent directory, and will effectively run dpkg -i on
the .deb. The ability to install the package with a very short
command is very useful when troubleshooting packages.
debit
Like debi, but also runs debian-test to test the package
after installation.
debc
List contents of current package. Do this after a successful
debuild to see if the package looks all right.
debclean
Clean a Debian source tree. debclean will clean all Debian
source trees below the current directory, and if requested, also
remove all files that were generated from these source trees (that is
any .deb, .dsc and .changes files). It will keep
the .diffs and original files, though, so that the binaries and
other files can be rebuilt if necessary.
uupdate
Update the package with an archive or patches from an upstream author.
This will be of help if you have to update your package. It will try
to apply the latest diffs to your package and tell you how successful
it was.
uscan
Automatically scan for and download upstream updates. uscan can
also call a program such as uupdate to attempt to update the
Debianised version based on the new update. Whilst uscan could
be used to release the updated version automatically, it is probably
better not to without testing it first.
dscverify
Check the signature and MD5 sums of a .dsc file against the most
current Debian keyring on your system.
mergechanges
Merge .changes files from the same release but built on
different architectures.
plotchangelog
Display information from a changelog graphically using gnuplot.
bts
A command-line tool for accessing the BTS, both to send mails to
control@bts.debian.org and to access the web pages of the BTS.
grep-excuses
Grep the update_excuses.html file to find out what is happening
to your packages.
/usr/share/doc/devscripts/examples
This directory contains examples of procmail and exim
scripts for sorting mail arriving to Debian mailing lists.
SEE ALSO
/usr/share/doc/devscripts/README, which has more information on
various aspects of this package. Also, see the manpages of the
individual programs.
AUTHORS
The devscripts package is currently maintained by Julian Gilbey
<jdg@debian.org>. The scripts are due to many different authors;
please see the individual manpages for credits.