a b c d e f g h i j k l m n o p q r s t u v w x y z

diff from 262338 and 281246

Description: scripts to make the life of a Debian Package maintainer easier
 Contains the following scripts, dependencies/recommendations shown in
 brackets afterwards:
 .
  - annotate-output: run a command and prepend time and stream (O for stdout,
    E for stderr) for every line of output
  - archpath: print tla/Bazaar package names [tla | bazaar]
  - bts: a command-line tool for manipulating the BTS [www-browser,
    libauthen-sasl-perl, libnet-smtps-perl, libsoap-lite-perl, liburi-perl,
    libwww-perl, bsd-mailx | mailx]
  - build-rdeps: search for all packages that build-depend on a given package
    [dctrl-tools, dose-extra, libdpkg-perl]
  - chdist: tool to easily play with several distributions [dctrl-tools]
  - checkbashisms: check whether a /bin/sh script contains any common
    bash-specific constructs
  - cowpoke: upload a Debian source package to a cowbuilder host and build it,
    optionally also signing and uploading the result to an incoming queue
    [ssh-client]
  - cvs-debi, cvs-debc: wrappers around debi and debc respectively (see below)
    which allow them to be called from the CVS working directory
    [cvs-buildpackage]
  - cvs-debrelease: wrapper around debrelease which allows it to be called
    from the CVS working directory [cvs-buildpackage, dupload | dput,
    ssh-client]
  - cvs-debuild: wrapper for cvs-buildpackage to use debuild as its package
    building program [cvs-buildpackage, fakeroot, lintian, gnupg | gnupg2]
  - dcmd: run a given command replacing the name of a .changes or .dsc file
    with each of the files referenced therein
  - dcontrol: remotely query package and source control files for all Debian
    distributions [liburl-perl, libwww-perl]
  - dd-list: given a list of packages, pretty-print it ordered by maintainer
  - debc: display the contents of just-built .debs
  - debchange/dch: automagically add entries to debian/changelog files
    [libdistro-info-perl, libsoap-lite-perl]
  - debcheckout: checkout the development repository of a Debian package
  - debclean: clean a Debian source tree [fakeroot]
  - debcommit: commit changes to cvs, darcs, svn, svk, tla, bzr, git, or hg,
    basing commit message on changelog [cvs | darcs | subversion | svk | tla |
    bzr | git-core | mercurial, libtimedate-perl]
  - debdiff: compare two versions of a Debian package to check for
    added and removed files. Use the diffoscope package for deep comparisons.
    [wdiff, patchutils]
  - debdiff-apply: apply unified diffs of two Debian source packages, such as
    generated by debdiff, to a target source package [python3-unidiff, quilt]
  - debi: install a just-built package
  - debpkg: dpkg wrapper to be able to manage/test packages without su
  - debrepro: reproducibility tester for Debian packages  [faketime,
    diffoscope, disorderfs]
  - debrelease: wrapper around dupload or dput [dupload | dput, ssh-client]
  - debsign, debrsign: sign a .changes/.dsc pair without needing any of
    the rest of the package to be present; can sign the pair remotely
    or fetch the pair from a remote machine for signing [gnupg | gnupg2,
    debian-keyring, ssh-client]
  - debsnap: grab packages from https://snapshot.debian.org [libwww-perl]
  - debuild: wrapper to build a package without having to su or worry
    about how to invoke dpkg to build using fakeroot.  Also deals
    with common environment problems, umask etc. [fakeroot, lintian,
    gnupg | gnupg2]
  - deb-reversion: increase a binary package version number and repacks the
    package, useful for porters and the like
  - dep3changelog: generate a changelog entry from a DEP3-style patch header
  - desktop2menu: given a freedesktop.org desktop file, generate a skeleton
    for a menu file [libfile-desktopentry-perl]
  - dget: download Debian source and binary packages [wget | curl]
  - diff2patches: extract patches from a .diff.gz file placing them under
    debian/ or, if present, debian/patches [patchutils]
  - dpkg-depcheck, dpkg-genbuilddeps: determine the packages used during
    the build of a Debian package; useful for determining the Build-Depends
    control field needed [build-essential, strace]
  - dscextract: extract a single file from a Debian source package [patchutils]
  - dscverify: verify the integrity of a Debian package from the
    .changes or .dsc files [gnupg | gnupg2, debian-keyring]
  - edit-patch: add/edit a patch for a source package and commit the changes
    [quilt | dpatch | cdbs]
  - getbuildlog: download package build logs from Debian auto-builders [wget]
  - git-deborig: try to produce Debian orig.tar using git-archive(1)
    [libdpkg-perl, libgit-wrapper-perl, liblist-compare-perl,
    libstring-shellquote-perl, libtry-tiny-perl]
  - grep-excuses: grep britney's excuses for your packages [libdbd-pg-perl,
    libterm-size-perl, libyaml-syck-perl, wget, w3m]
  - hardening-check: report the hardening characteristics of a set of binaries
  - list-unreleased: search for unreleased packages
  - ltnu: List all uploads of packages by the given uploader or maintainer and
    display them ordered by the last upload [postgresql-client]
  - manpage-alert: locate binaries without corresponding manpages [man-db]
  - mass-bug: mass-file bug reports [bsd-mailx | mailx]
  - mergechanges: merge .changes files from the same release but built
    on different architectures
  - mk-build-deps: given a package name and/or control file, generate a binary
    package which may be installed to satisfy the build-dependencies of the
    given package [equivs]
  - mk-origtargz: rename upstream tarball, optionally changing the compression
    and removing unwanted files [unzip, xz-utils, file]
  - namecheck: check project names are not already taken
  - nmudiff: mail a diff of the current package against the previous version
    to the BTS to assist in tracking NMUs [patchutils, mutt]
  - origtargz: fetch the orig tarball of a Debian package from various sources,
    and unpack it
  - plotchangelog: view a nice plot of the data in a changelog file
    [libtimedate-perl, gnuplot]
  - pts-subscribe: subscribe to the PTS for a limited period of time
    [bsd-mailx | mailx, at]
  - rc-alert: list installed packages which have release-critical bugs
    [wget | curl]
  - reproducible-check: reports on the reproducible status of installed
    packages [python3-apt, python3-requests, python3-termcolor, python3-xdg]
  - rmadison: remotely query the Debian archive database about packages
    [liburi-perl, wget | curl]
  - sadt: run DEP-8 tests [python3-debian]
  - suspicious-source: output a list of files which are not common source
    files [python3-magic]
  - svnpath: print Subversion repository paths [subversion]
  - tagpending: run from a Debian source tree and tag bugs that are to be
    closed in the latest changelog as pending [libsoap-lite-perl]
  - transition-check: check a list of source packages for involvement in
    transitions for which uploads to unstable are currently blocked
    [libwww-perl, libyaml-syck-perl]
  - uscan: scan upstream sites for new releases of packages [gpgv | gpgv2,
    gnupg |gnupg2, liblwp-protocol-https-perl, libwww-perl, unzip,
    xz-utils, file]
  - uupdate: integrate upstream changes into a source package [patch]
  - what-patch: determine what patch system, if any, a source package is using
    [patchutils]
  - whodepends: check which maintainers' packages depend on a package
  - who-uploads: determine the most recent uploaders of a package to the Debian
    archive [gnupg | gnupg2, debian-keyring, debian-maintainers, wget]
  - wnpp-alert: list installed packages which are orphaned or up for adoption
    [wget | curl]
  - wnpp-check: check whether there is an open request for packaging or
    intention to package bug for a package [wget | curl]
  - who-permits-upload: Retrieve information about Debian Maintainer access
    control lists [gnupg | gnupg2, libencode-locale-perl, libwww-perl,
    debian-keyring]
  - wrap-and-sort: wrap long lines and sort items in packaging files
    [python3-debian]
 .
 Also included are a set of example mail filters for filtering mail
 from Debian mailing lists using exim, procmail, etc.
Description: scripts to make the life of a Debian Package maintainer easier
 Contains the following scripts, dependencies/recommendations shown in
 brackets afterwards:
 .
  - annotate-output: run a command and prepend time and stream (O for stdout,
    E for stderr) for every line of output.
  - archpath: Prints arch (tla/Bazaar) package names. Also supports
    calculating the package names for other branches. [tla | bazaar]
  - bts: A command-line tool for accessing the Debian Bug Tracking System, both
    to send mails to control@bts.debian.org and to access the web pages and
    SOAP interface of the BTS. [www-browser, libauthen-sasl-perl,
    libnet-smtps-perl, libsoap-lite-perl, liburi-perl, libwww-perl,
    bsd-mailx | mailx]
  - build-rdeps: Searches for all packages that build-depend on a given package.
    [dctrl-tools, dose-extra, libdpkg-perl]
  - chdist: tool to easily play with several distributions. [dctrl-tools]
  - checkbashisms: check whether a /bin/sh script contains any common
    bash-specific constructs.
  - cowpoke: upload a Debian source package to a cowbuilder host and build it,
    optionally also signing and uploading the result to an incoming queue.
    [ssh-client]
  - cvs-debi, cvs-debc: wrappers around debi and debc respectively (see below)
    which allow them to be called from the CVS working directory.
    [cvs-buildpackage]
  - cvs-debrelease: wrapper around debrelease which allows it to be called
    from the CVS working directory. [cvs-buildpackage, dupload | dput,
    ssh-client]
  - cvs-debuild: A wrapper for cvs-buildpackage to use debuild as its package
    building program. [cvs-buildpackage, fakeroot, lintian, gnupg |gnupg2]
  - dcmd: run a given command replacing the name of a .changes or .dsc file
    with each of the files referenced therein. *
  - dd-list: given a list of packages, pretty-print it ordered by maintainer. *
  - debbisect: bisect snapshot.debian.org to find which change in the archive
    introduced a certain problem. [mmdebstrap, python3-debian]
  - debc: List contents of current package.  Do this after a successful
    "debuild" to see if the package looks all right.
  - debchange (abbreviation 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.
    [libdistro-info-perl, libsoap-lite-perl]*
  - debcheckout: checkout the development repository of a Debian package. *
  - 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 .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.
    [fakeroot]*
  - debcommit: Commits changes to cvs, darcs, svn, svk, tla, bzr, git, or hg,
    using new entries in debian/changelog as the commit message. Also supports
    tagging Debian package releases. [cvs | darcs | subversion | svk | tla |
    bzr | git-core | mercurial, libtimedate-perl]
  - 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 inadvertently lost between versions.  Can also examine
    two .dsc files and report on the changes between source versions.
    For a deeper comparison one can use the diffoscope package.
    [wdiff, patchutils]*
  - debdiff-apply: Apply unified diffs of two Debian source packages, such as
    those generated by debdiff, to a target Debian source package. Any changes
    to debian/changelog are dealt with specially, to avoid the conflicts that
    changelog diffs typically produce when applied naively. May be used to check
    that old patches still apply to newer versions of those packages.
    [python3-debian, python3-unidiff, quilt]
  - debi: Installs the current package by using the setuid root debpkg
    script described below.  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.
  - 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,
    and this needs to be performed by the sysadmin -- it is not
    installed as setuid root by default.  (Note that being able to run a
    setuid root debpkg is effectively the same as having root access to
    the system, so this should be done with caution.)  Having debpkg as
    a wrapper for dpkg can be a Good Thing (TM), as it decreases the
    potential for damage by accidental wrong use of commands in
    superuser mode (e.g., an inadvertent rm -rf * in the wrong directory
    is disastrous as many can attest to).
  - 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. [dupload | dput, ssh-client]
  - debrebuild: A script that provided a .buildinfo file reports the
    instructions on how to try to reproduce the reported build.
  - debrepro: A script that tests reproducibility of Debian packages. It will
    build a given source directory twice, with a set of variation between the
    first and second build, and compare the binary packages produced. If
    diffoscope is installed, it is used to compare non-matching binaries. If
    disorderfs is installed, it is used during the build to inject
    non-determinism in filesystem listing operations.
    [faketime, diffoscope, disorderfs]
  - debrsign: This transfers a .changes/.dsc pair to a remote machine for
    signing, and runs debsign on the remote machine over an SSH connection.
    [gnupg | gnupg2, debian-keyring, ssh-client]
  - debsign: Use GNU Privacy Guard to sign the changes (and possibly 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. [gnupg |gnupg2,
    debian-keyring, ssh-client]*
  - debsnap: grab packages from https://snapshot.debian.org [libwww-perl,
    libjson-perl]
  - debuild: A wrapper for building a package (i.e., 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. [fakeroot, lintian, gnupg | gnupg2]*
  - deb-reversion: increases a binary package version number and repacks the
    package, useful for porters and the like.
  - deb-why-removed: shows the reason a package was removed from the archive.
    [libdpkg-perl]
  - dep3changelog: generate a changelog entry from a DEP3-style patch header.
  - desktop2menu: given a freedesktop.org desktop file, generate a skeleton
    for a menu file. [libfile-desktopentry-perl]
  - dget: Downloads Debian source and binary packages. Point at a .changes or
    .dsc to download all references files. Specify a package name to download
    it from the configured apt repository. [wget | curl]
  - diff2patches: extracts patches from a .diff.gz file placing them under
    debian/ or, if present, debian/patches. [patchutils]
  - 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. [build-essential, strace]
  - dscextract: extract a single file from a Debian source package. [patchutils]
  - dscverify: check the signature and MD5 sums of a dsc file against the most
    current Debian keyring on your system. [gnupg | gnupg2, debian-keyring]
  - edit-patch: add/edit a patch for a source package and commit the changes.
    [quilt | dpatch | cdbs]
  - getbuildlog: download package build logs from Debian auto-builders. [wget]
  - git-deborig: try to produce Debian orig.tar using git-archive(1).
    [libdpkg-perl, libgit-wrapper-perl, liblist-compare-perl,
    libstring-shellquote-perl, libtry-tiny-perl]
  - grep-excuses: grep britney's excuses to find out what is happening to your
    packages. [libdbd-pg-perl, libterm-size-perl, libyaml-syck-perl, wget, w3m]
  - hardening-check: report the hardening characteristics of a set of binaries.
  - list-unreleased: searches for packages marked UNRELEASED in their
    changelog.
  - ltnu (Long Time No Upload): List all uploads of packages by the
    given uploader or maintainer and display them ordered by the last
    upload of that package, oldest uploads first.
  - manpage-alert: locate binaries without corresponding manpages. [man-db]
  - mass-bug: mass-file bug reports. [bsd-mailx | mailx]
  - mergechanges: merge .changes files from the same release but built
    on different architectures.
  - mk-build-deps: Given a package name and/or control file, generate a binary
    package which may be installed to satisfy the build-dependencies of the
    given package. [equivs]
  - mk-origtargz: Rename upstream tarball, optionally changing the compression
    and removing unwanted files.
    [libfile-which-perl, unzip, xz-utils, file]
  - namecheck: Check project names are not already taken.
  - nmudiff: prepare a diff of this version (presumably an NMU against the
    previously released version (as per the changelog) and submit the diff
    to the BTS. [patchutils, mutt]
  - origtargz: fetch the orig tarball of a Debian package from various sources,
    and unpack it. [pristine-tar]
  - plotchangelog: display information from a changelog graphically using
    gnuplot. [libtimedate-perl, gnuplot]
  - pts-subscribe: subscribe to the PTS (Package Tracking System) for a
    limited period of time. [bsd-mailx | mailx, at]
  - rc-alert: list installed packages which have release-critical bugs.
    [wget | curl]
  - reproducible-check: reports on the reproducible status of installed
    packages. For more details please see <https://reproducible-builds.org>.
  - rmadison: remotely query the Debian archive database about packages.
    [liburi-perl, wget | curl]
  - sadt: run DEP-8 tests. [python3-debian]
  - salsa: manipulates salsa.debian.org repositories and users
    [libgitlab-api-v4-perl]
  - suspicious-source: output a list of files which are not common source
    files. [python3-magic]
  - svnpath: Prints the path to the Subversion repository of a Subversion
    checkout. Also supports calculating the paths for branches and
    tags in a repository independent fashion. Used by debcommit to generate
    svn tags. [subversion]
  - tagpending: runs from a Debian source tree and tags bugs that are to be
    closed in the latest changelog as pending. [libsoap-lite-perl]
  - transition-check: Check a list of source packages for involvement in
    transitions for which uploads to unstable are currently blocked.
    [libwww-perl, libyaml-syck-perl]
  - 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.  Uscan can also verify detached OpenPGP signatures if
    upstream's signing key is known. [file, gpgv | gpgv2, gnupg | gnupg2,
    libfile-dirlist-perl, libfile-touch-perl, libfile-which-perl,
    liblwp-protocol-https-perl, libmoo-perl, libwww-perl, unzip, xz-utils]*
  - 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. [patch]
  - what-patch: determine what patch system, if any, a source package is using.
    [patchutils]
  - whodepends: check which maintainers' packages depend on a package.
  - who-permits-upload: Retrieve information about Debian Maintainer access
    control lists. [gnupg | gnupg2, libencode-locale-perl, libwww-perl,
    debian-keyring]
  - who-uploads: determine the most recent uploaders of a package to the Debian
    archive. [gnupg | gnupg2, debian-keyring, debian-maintainers, wget]
  - wnpp-alert: list installed packages which are orphaned or up for adoption.
    [wget | curl]
  - wnpp-check: check whether there is an open request for packaging or
    intention to package bug for a package. [wget | curl]
  - wrap-and-sort: wrap long lines and sort items in packaging files.
    [python3-debian]
  - /usr/share/doc/devscripts/examples: This directory contains examples of
    procmail and exim scripts for sorting mail arriving to Debian
    mailing lists.
--- 262338	Thu Jan  1 00:00:00 1970
+++ 281246	Thu Jan  1 00:00:00 1970
@@ -3,136 +3,212 @@
  brackets afterwards:
  .
   - annotate-output: run a command and prepend time and stream (O for stdout,
-    E for stderr) for every line of output
-  - archpath: print tla/Bazaar package names [tla | bazaar]
-  - bts: a command-line tool for manipulating the BTS [www-browser,
-    libauthen-sasl-perl, libnet-smtps-perl, libsoap-lite-perl, liburi-perl,
-    libwww-perl, bsd-mailx | mailx]
-  - build-rdeps: search for all packages that build-depend on a given package
+    E for stderr) for every line of output.
+  - archpath: Prints arch (tla/Bazaar) package names. Also supports
+    calculating the package names for other branches. [tla | bazaar]
+  - bts: A command-line tool for accessing the Debian Bug Tracking System, both
+    to send mails to control@bts.debian.org and to access the web pages and
+    SOAP interface of the BTS. [www-browser, libauthen-sasl-perl,
+    libnet-smtps-perl, libsoap-lite-perl, liburi-perl, libwww-perl,
+    bsd-mailx | mailx]
+  - build-rdeps: Searches for all packages that build-depend on a given package.
     [dctrl-tools, dose-extra, libdpkg-perl]
-  - chdist: tool to easily play with several distributions [dctrl-tools]
+  - chdist: tool to easily play with several distributions. [dctrl-tools]
   - checkbashisms: check whether a /bin/sh script contains any common
-    bash-specific constructs
+    bash-specific constructs.
   - cowpoke: upload a Debian source package to a cowbuilder host and build it,
-    optionally also signing and uploading the result to an incoming queue
+    optionally also signing and uploading the result to an incoming queue.
     [ssh-client]
   - cvs-debi, cvs-debc: wrappers around debi and debc respectively (see below)
-    which allow them to be called from the CVS working directory
+    which allow them to be called from the CVS working directory.
     [cvs-buildpackage]
   - cvs-debrelease: wrapper around debrelease which allows it to be called
-    from the CVS working directory [cvs-buildpackage, dupload | dput,
+    from the CVS working directory. [cvs-buildpackage, dupload | dput,
     ssh-client]
-  - cvs-debuild: wrapper for cvs-buildpackage to use debuild as its package
-    building program [cvs-buildpackage, fakeroot, lintian, gnupg | gnupg2]
+  - cvs-debuild: A wrapper for cvs-buildpackage to use debuild as its package
+    building program. [cvs-buildpackage, fakeroot, lintian, gnupg |gnupg2]
   - dcmd: run a given command replacing the name of a .changes or .dsc file
-    with each of the files referenced therein
-  - dcontrol: remotely query package and source control files for all Debian
-    distributions [liburl-perl, libwww-perl]
-  - dd-list: given a list of packages, pretty-print it ordered by maintainer
-  - debc: display the contents of just-built .debs
-  - debchange/dch: automagically add entries to debian/changelog files
-    [libdistro-info-perl, libsoap-lite-perl]
-  - debcheckout: checkout the development repository of a Debian package
-  - debclean: clean a Debian source tree [fakeroot]
-  - debcommit: commit changes to cvs, darcs, svn, svk, tla, bzr, git, or hg,
-    basing commit message on changelog [cvs | darcs | subversion | svk | tla |
+    with each of the files referenced therein. *
+  - dd-list: given a list of packages, pretty-print it ordered by maintainer. *
+  - debbisect: bisect snapshot.debian.org to find which change in the archive
+    introduced a certain problem. [mmdebstrap, python3-debian]
+  - debc: List contents of current package.  Do this after a successful
+    "debuild" to see if the package looks all right.
+  - debchange (abbreviation 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.
+    [libdistro-info-perl, libsoap-lite-perl]*
+  - debcheckout: checkout the development repository of a Debian package. *
+  - 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 .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.
+    [fakeroot]*
+  - debcommit: Commits changes to cvs, darcs, svn, svk, tla, bzr, git, or hg,
+    using new entries in debian/changelog as the commit message. Also supports
+    tagging Debian package releases. [cvs | darcs | subversion | svk | tla |
     bzr | git-core | mercurial, libtimedate-perl]
-  - debdiff: compare two versions of a Debian package to check for
-    added and removed files. Use the diffoscope package for deep comparisons.
-    [wdiff, patchutils]
-  - debdiff-apply: apply unified diffs of two Debian source packages, such as
-    generated by debdiff, to a target source package [python3-unidiff, quilt]
-  - debi: install a just-built package
-  - debpkg: dpkg wrapper to be able to manage/test packages without su
-  - debrepro: reproducibility tester for Debian packages  [faketime,
-    diffoscope, disorderfs]
-  - debrelease: wrapper around dupload or dput [dupload | dput, ssh-client]
-  - debsign, debrsign: sign a .changes/.dsc pair without needing any of
-    the rest of the package to be present; can sign the pair remotely
-    or fetch the pair from a remote machine for signing [gnupg | gnupg2,
-    debian-keyring, ssh-client]
-  - debsnap: grab packages from https://snapshot.debian.org [libwww-perl]
-  - debuild: wrapper to build a package without having to su or worry
-    about how to invoke dpkg to build using fakeroot.  Also deals
-    with common environment problems, umask etc. [fakeroot, lintian,
-    gnupg | gnupg2]
-  - deb-reversion: increase a binary package version number and repacks the
-    package, useful for porters and the like
-  - dep3changelog: generate a changelog entry from a DEP3-style patch header
+  - 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 inadvertently lost between versions.  Can also examine
+    two .dsc files and report on the changes between source versions.
+    For a deeper comparison one can use the diffoscope package.
+    [wdiff, patchutils]*
+  - debdiff-apply: Apply unified diffs of two Debian source packages, such as
+    those generated by debdiff, to a target Debian source package. Any changes
+    to debian/changelog are dealt with specially, to avoid the conflicts that
+    changelog diffs typically produce when applied naively. May be used to check
+    that old patches still apply to newer versions of those packages.
+    [python3-debian, python3-unidiff, quilt]
+  - debi: Installs the current package by using the setuid root debpkg
+    script described below.  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.
+  - 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,
+    and this needs to be performed by the sysadmin -- it is not
+    installed as setuid root by default.  (Note that being able to run a
+    setuid root debpkg is effectively the same as having root access to
+    the system, so this should be done with caution.)  Having debpkg as
+    a wrapper for dpkg can be a Good Thing (TM), as it decreases the
+    potential for damage by accidental wrong use of commands in
+    superuser mode (e.g., an inadvertent rm -rf * in the wrong directory
+    is disastrous as many can attest to).
+  - 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. [dupload | dput, ssh-client]
+  - debrebuild: A script that provided a .buildinfo file reports the
+    instructions on how to try to reproduce the reported build.
+  - debrepro: A script that tests reproducibility of Debian packages. It will
+    build a given source directory twice, with a set of variation between the
+    first and second build, and compare the binary packages produced. If
+    diffoscope is installed, it is used to compare non-matching binaries. If
+    disorderfs is installed, it is used during the build to inject
+    non-determinism in filesystem listing operations.
+    [faketime, diffoscope, disorderfs]
+  - debrsign: This transfers a .changes/.dsc pair to a remote machine for
+    signing, and runs debsign on the remote machine over an SSH connection.
+    [gnupg | gnupg2, debian-keyring, ssh-client]
+  - debsign: Use GNU Privacy Guard to sign the changes (and possibly 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. [gnupg |gnupg2,
+    debian-keyring, ssh-client]*
+  - debsnap: grab packages from https://snapshot.debian.org [libwww-perl,
+    libjson-perl]
+  - debuild: A wrapper for building a package (i.e., 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. [fakeroot, lintian, gnupg | gnupg2]*
+  - deb-reversion: increases a binary package version number and repacks the
+    package, useful for porters and the like.
+  - deb-why-removed: shows the reason a package was removed from the archive.
+    [libdpkg-perl]
+  - dep3changelog: generate a changelog entry from a DEP3-style patch header.
   - desktop2menu: given a freedesktop.org desktop file, generate a skeleton
-    for a menu file [libfile-desktopentry-perl]
-  - dget: download Debian source and binary packages [wget | curl]
-  - diff2patches: extract patches from a .diff.gz file placing them under
-    debian/ or, if present, debian/patches [patchutils]
-  - dpkg-depcheck, dpkg-genbuilddeps: determine the packages used during
-    the build of a Debian package; useful for determining the Build-Depends
-    control field needed [build-essential, strace]
-  - dscextract: extract a single file from a Debian source package [patchutils]
-  - dscverify: verify the integrity of a Debian package from the
-    .changes or .dsc files [gnupg | gnupg2, debian-keyring]
-  - edit-patch: add/edit a patch for a source package and commit the changes
+    for a menu file. [libfile-desktopentry-perl]
+  - dget: Downloads Debian source and binary packages. Point at a .changes or
+    .dsc to download all references files. Specify a package name to download
+    it from the configured apt repository. [wget | curl]
+  - diff2patches: extracts patches from a .diff.gz file placing them under
+    debian/ or, if present, debian/patches. [patchutils]
+  - 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. [build-essential, strace]
+  - dscextract: extract a single file from a Debian source package. [patchutils]
+  - dscverify: check the signature and MD5 sums of a dsc file against the most
+    current Debian keyring on your system. [gnupg | gnupg2, debian-keyring]
+  - edit-patch: add/edit a patch for a source package and commit the changes.
     [quilt | dpatch | cdbs]
-  - getbuildlog: download package build logs from Debian auto-builders [wget]
-  - git-deborig: try to produce Debian orig.tar using git-archive(1)
+  - getbuildlog: download package build logs from Debian auto-builders. [wget]
+  - git-deborig: try to produce Debian orig.tar using git-archive(1).
     [libdpkg-perl, libgit-wrapper-perl, liblist-compare-perl,
     libstring-shellquote-perl, libtry-tiny-perl]
-  - grep-excuses: grep britney's excuses for your packages [libdbd-pg-perl,
-    libterm-size-perl, libyaml-syck-perl, wget, w3m]
-  - hardening-check: report the hardening characteristics of a set of binaries
-  - list-unreleased: search for unreleased packages
-  - ltnu: List all uploads of packages by the given uploader or maintainer and
-    display them ordered by the last upload [postgresql-client]
-  - manpage-alert: locate binaries without corresponding manpages [man-db]
-  - mass-bug: mass-file bug reports [bsd-mailx | mailx]
+  - grep-excuses: grep britney's excuses to find out what is happening to your
+    packages. [libdbd-pg-perl, libterm-size-perl, libyaml-syck-perl, wget, w3m]
+  - hardening-check: report the hardening characteristics of a set of binaries.
+  - list-unreleased: searches for packages marked UNRELEASED in their
+    changelog.
+  - ltnu (Long Time No Upload): List all uploads of packages by the
+    given uploader or maintainer and display them ordered by the last
+    upload of that package, oldest uploads first.
+  - manpage-alert: locate binaries without corresponding manpages. [man-db]
+  - mass-bug: mass-file bug reports. [bsd-mailx | mailx]
   - mergechanges: merge .changes files from the same release but built
-    on different architectures
-  - mk-build-deps: given a package name and/or control file, generate a binary
+    on different architectures.
+  - mk-build-deps: Given a package name and/or control file, generate a binary
     package which may be installed to satisfy the build-dependencies of the
-    given package [equivs]
-  - mk-origtargz: rename upstream tarball, optionally changing the compression
-    and removing unwanted files [unzip, xz-utils, file]
-  - namecheck: check project names are not already taken
-  - nmudiff: mail a diff of the current package against the previous version
-    to the BTS to assist in tracking NMUs [patchutils, mutt]
+    given package. [equivs]
+  - mk-origtargz: Rename upstream tarball, optionally changing the compression
+    and removing unwanted files.
+    [libfile-which-perl, unzip, xz-utils, file]
+  - namecheck: Check project names are not already taken.
+  - nmudiff: prepare a diff of this version (presumably an NMU against the
+    previously released version (as per the changelog) and submit the diff
+    to the BTS. [patchutils, mutt]
   - origtargz: fetch the orig tarball of a Debian package from various sources,
-    and unpack it
-  - plotchangelog: view a nice plot of the data in a changelog file
-    [libtimedate-perl, gnuplot]
-  - pts-subscribe: subscribe to the PTS for a limited period of time
-    [bsd-mailx | mailx, at]
-  - rc-alert: list installed packages which have release-critical bugs
+    and unpack it. [pristine-tar]
+  - plotchangelog: display information from a changelog graphically using
+    gnuplot. [libtimedate-perl, gnuplot]
+  - pts-subscribe: subscribe to the PTS (Package Tracking System) for a
+    limited period of time. [bsd-mailx | mailx, at]
+  - rc-alert: list installed packages which have release-critical bugs.
     [wget | curl]
   - reproducible-check: reports on the reproducible status of installed
-    packages [python3-apt, python3-requests, python3-termcolor, python3-xdg]
-  - rmadison: remotely query the Debian archive database about packages
+    packages. For more details please see <https://reproducible-builds.org>.
+  - rmadison: remotely query the Debian archive database about packages.
     [liburi-perl, wget | curl]
-  - sadt: run DEP-8 tests [python3-debian]
+  - sadt: run DEP-8 tests. [python3-debian]
+  - salsa: manipulates salsa.debian.org repositories and users
+    [libgitlab-api-v4-perl]
   - suspicious-source: output a list of files which are not common source
-    files [python3-magic]
-  - svnpath: print Subversion repository paths [subversion]
-  - tagpending: run from a Debian source tree and tag bugs that are to be
-    closed in the latest changelog as pending [libsoap-lite-perl]
-  - transition-check: check a list of source packages for involvement in
-    transitions for which uploads to unstable are currently blocked
+    files. [python3-magic]
+  - svnpath: Prints the path to the Subversion repository of a Subversion
+    checkout. Also supports calculating the paths for branches and
+    tags in a repository independent fashion. Used by debcommit to generate
+    svn tags. [subversion]
+  - tagpending: runs from a Debian source tree and tags bugs that are to be
+    closed in the latest changelog as pending. [libsoap-lite-perl]
+  - transition-check: Check a list of source packages for involvement in
+    transitions for which uploads to unstable are currently blocked.
     [libwww-perl, libyaml-syck-perl]
-  - uscan: scan upstream sites for new releases of packages [gpgv | gpgv2,
-    gnupg |gnupg2, liblwp-protocol-https-perl, libwww-perl, unzip,
-    xz-utils, file]
-  - uupdate: integrate upstream changes into a source package [patch]
-  - what-patch: determine what patch system, if any, a source package is using
+  - 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.  Uscan can also verify detached OpenPGP signatures if
+    upstream's signing key is known. [file, gpgv | gpgv2, gnupg | gnupg2,
+    libfile-dirlist-perl, libfile-touch-perl, libfile-which-perl,
+    liblwp-protocol-https-perl, libmoo-perl, libwww-perl, unzip, xz-utils]*
+  - 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. [patch]
+  - what-patch: determine what patch system, if any, a source package is using.
     [patchutils]
-  - whodepends: check which maintainers' packages depend on a package
+  - whodepends: check which maintainers' packages depend on a package.
+  - who-permits-upload: Retrieve information about Debian Maintainer access
+    control lists. [gnupg | gnupg2, libencode-locale-perl, libwww-perl,
+    debian-keyring]
   - who-uploads: determine the most recent uploaders of a package to the Debian
-    archive [gnupg | gnupg2, debian-keyring, debian-maintainers, wget]
-  - wnpp-alert: list installed packages which are orphaned or up for adoption
+    archive. [gnupg | gnupg2, debian-keyring, debian-maintainers, wget]
+  - wnpp-alert: list installed packages which are orphaned or up for adoption.
     [wget | curl]
   - wnpp-check: check whether there is an open request for packaging or
-    intention to package bug for a package [wget | curl]
-  - who-permits-upload: Retrieve information about Debian Maintainer access
-    control lists [gnupg | gnupg2, libencode-locale-perl, libwww-perl,
-    debian-keyring]
-  - wrap-and-sort: wrap long lines and sort items in packaging files
+    intention to package bug for a package. [wget | curl]
+  - wrap-and-sort: wrap long lines and sort items in packaging files.
     [python3-debian]
- .
+  - /usr/share/doc/devscripts/examples: This directory contains examples of
- Also included are a set of example mail filters for filtering mail
+    procmail and exim scripts for sorting mail arriving to Debian
- from Debian mailing lists using exim, procmail, etc.
+    mailing lists.