Generate the description of d/control from the content of the README.
Try to DRY the list of scripts and their descriptions.
This is the wdiff coming from debdiff compared to 2.18.6:
E for stderr) for every line of [-output-] {+output.+}
- archpath: [-print tla/Bazaar-] {+Prints arch (tla/Bazaar) package names. Also supports+}
{+ calculating the+} package names {+for other branches.+} [tla | bazaar]
- bts: [-a-] {+A+} command-line tool for [-manipulating-] {+accessing the BTS, both to+}
{+ send mails to control@bts.debian.org and to access the web pages and+}
{+ SOAP interface of+} the [-BTS-] {+BTS.+} [www-browser, libauthen-sasl-perl,
- build-rdeps: [-search-] {+Searches+} for all packages that build-depend on a given [-package-] {+package.+}
- chdist: tool to easily play with several [-distributions-] {+distributions.+} [dctrl-tools]
bash-specific [-constructs-] {+constructs.+}
optionally also signing and uploading the result to an incoming [-queue-] {+queue.+}
which allow them to be called from the CVS working [-directory-] {+directory.+}
from the CVS working [-directory-] {+directory.+} [cvs-buildpackage, dupload | dput,
- cvs-debuild: {+A+} wrapper for cvs-buildpackage to use debuild as its package
building [-program-] {+program.+} [cvs-buildpackage, fakeroot, lintian, gnupg [-| gnupg2]-] {+|gnupg2]+}
with each of the files referenced [-therein-] {+therein. *+}
[-distributions-]
{+distributions.+} [liburl-perl, libwww-perl]
- dd-list: given a list of packages, pretty-print it ordered by [-maintainer-] {+maintainer. *+}
- debc: [-display the-] {+List+} contents of [-just-built .debs-] {+current package. Do this after a successful+}
{+ "debuild" to see if the package looks all right.+}
- [-debchange/dch: automagically-] {+debchange (abbreviation dch): Modifies debian/changelog and manages version+}
{+ numbers for you. It will either increment the version number or+} add [-entries-] {+an+}
{+ entry for the current version, depending upon the options given+} to [-debian/changelog files-] {+it.+}
[libdistro-info-perl, [-libsoap-lite-perl]-] {+libsoap-lite-perl]*+}
- debcheckout: checkout the development repository of a Debian [-package-] {+package. *+}
- debclean: [-clean-] {+Clean+} a Debian source [-tree [fakeroot]-] {+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: [-commit-] {+Commits+} changes to cvs, darcs, svn, svk, tla, bzr, git, or hg,
[-basing-]
{+using new entries in debian/changelog as the+} commit [-message on changelog-] {+message. Also supports+}
{+ tagging Debian package releases.+} [cvs | darcs | subversion | svk | tla |
- debdiff: [-compare-] {+A program which examines+} two [-versions of a Debian package to check-] {+.deb files or two .changes files and+}
{+ reports on any difference found in their file lists. Useful+} for
[-added-] {+ensuring+}
{+ that no files were inadvertently lost between versions. Can also examine+}
{+ two .dsc files+} and [-removed files. Use-] {+report on the changes between source versions.+}
{+ For a deeper comparison one can use+} the diffoscope [-package for deep comparisons.-] {+package.+}
[wdiff, [-patchutils]-] {+patchutils]*+}
- debdiff-apply: [-apply-] {+Apply+} unified diffs of two Debian source packages, such as
{+those+} generated by debdiff, to a target {+Debian+} source [-package [python3-unidiff,-] {+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 [-a just-built-] {+the+} package {+with a very short command is very+}
{+ useful when troubleshooting packages.+}
- debpkg: [-dpkg-] {+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 [-manage/test packages without su-]
[- - debrepro: reproducibility tester-] {+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 [-Debian packages [faketime,-]
[- diffoscope, disorderfs]-] {+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]
- [-debsign, debrsign: sign-] {+debrepro: A script that tests reproducibility of Debian packages. It will+}
{+ build+} a [-.changes/.dsc pair without needing any-] {+given source directory twice, with a set+} of {+variation between+} the [-rest of-]
{+first and second build, and compare+} the [-package-] {+binary packages produced. If+}
{+ diffoscope is installed, it is used+} to [-be present; can sign the pair remotely-]
[- or fetch-] {+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 [-from-] {+to+} a remote machine for [-signing-]
{+signing, and runs debsign on the remote machine over an SSH connection.+}
- {+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]-] {+[libwww-perl,+}
{+ libjson-perl]+}
- debuild: {+A+} wrapper {+for building a package (i.e., dpkg-buildpackage)+} to [-build-]
{+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 [-without having-] {+by default, but+}
{+ can be instructed+} to [-su-] {+use any other gain-root command,+} or [-worry-]
[- about how to invoke dpkg-] {+can even be+}
{+ installed setuid root. Debuild can also be used+} to [-build using fakeroot. Also deals-] {+run various of+}
{+ the debian/rules operations+} with [-common environment problems, umask etc.-] {+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]-] {+gnupg2]*+}
- deb-reversion: [-increase-] {+increases+} a binary package version number and repacks the
package, useful for porters and the [-like-] {+like.+}
- dep3changelog: generate a changelog entry from a DEP3-style patch [-header-] {+header.+}
for a menu [-file-] {+file.+} [libfile-desktopentry-perl]
- dget: [-download-] {+Downloads+} Debian source and binary [-packages-] {+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: [-extract-] {+extracts+} patches from a .diff.gz file placing them under
debian/ or, if present, [-debian/patches-] {+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 [-of a Debian package; useful for determining-] {+process. This information can be helpful+}
{+ when trying to determine+} the [-Build-Depends-]
[- control field-] {+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-] {+package.+} [patchutils]
- dscverify: [-verify-] {+check+} the [-integrity-] {+signature and MD5 sums+} of a [-Debian package from-] {+dsc file against+} the
[-.changes or .dsc files-] {+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-] {+changes.+}
- getbuildlog: download package build logs from Debian [-auto-builders-] {+auto-builders.+} [wget]
- git-deborig: try to produce Debian orig.tar using [-git-archive(1)-] {+git-archive(1).+}
- grep-excuses: grep britney's excuses [-for-] {+to find out what is happening to+} your [-packages-]
{+packages.+} [libdbd-pg-perl, libterm-size-perl, libyaml-syck-perl, wget, w3m]
- hardening-check: report the hardening characteristics of a set of [-binaries-] {+binaries.+}
- list-unreleased: [-search-] {+searches+} for [-unreleased-] packages {+marked UNRELEASED in their+}
{+ changelog.+}
- [-ltnu:-] {+ltnu (Long Time No Upload):+} List all uploads of packages by the
upload [-[postgresql-client]-] {+of that package, oldest uploads first.+}
- manpage-alert: locate binaries without corresponding [-manpages-] {+manpages.+} [man-db]
- mass-bug: mass-file bug [-reports-] {+reports.+} [bsd-mailx | mailx]
on different [-architectures-] {+architectures.+}
- mk-build-deps: [-given-] {+Given+} a package name and/or control file, generate a binary
given [-package-] {+package.+} [equivs]
- mk-origtargz: [-rename-] {+Rename+} upstream tarball, optionally changing the compression
and removing unwanted [-files [unzip,-] {+files.+}
{+ [libfile-which-perl, unzip,+} xz-utils, file]
- namecheck: [-check-] {+Check+} project names are not already [-taken-] {+taken.+}
- nmudiff: [-mail-] {+prepare+} a diff of [-the current package-] {+this version (presumably an NMU+} against the [-previous-]
{+previously released+} version
[-to-] {+(as per+} the [-BTS-] {+changelog) and submit the diff+}
to [-assist in tracking NMUs-] {+the BTS.+} [patchutils, mutt]
and unpack [-it-] {+it.+}
- plotchangelog: [-view a nice plot of the data in-] {+display information from+} a changelog [-file-] {+graphically using+}
{+ gnuplot.+} [libtimedate-perl, gnuplot]
- pts-subscribe: subscribe to the PTS {+(Package Tracking System)+} for a
limited period of [-time-] {+time.+} [bsd-mailx | mailx, at]
- rc-alert: list installed packages which have release-critical [-bugs-] {+bugs.+}
- [-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.+}
- sadt: run DEP-8 [-tests-] {+tests.+} [python3-debian]
[-files-]
{+files.+} [python3-magic]
- svnpath: [-print-] {+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: [-run-] {+runs+} from a Debian source tree and [-tag-] {+tags+} bugs that are to be
closed in the latest changelog as [-pending-] {+pending.+} [libsoap-lite-perl]
- transition-check: [-check-] {+Check+} a list of source packages for involvement in
transitions for which uploads to unstable are currently [-blocked-] {+blocked.+}
- uscan: {+Automatically+} scan [-upstream sites-] 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 [-releases of packages [gpgv-] {+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,-] {+| gnupg2,+}
libfile-which-perl, [-libipc-run-perl,-] liblwp-protocol-https-perl, libmoo-perl, libwww-perl,
unzip, [-xz-utils,-]
[- file]-] {+xz-utils]*+}
- uupdate: [-integrate-] {+Update the package with an archive or patches from+}
{+ an+} upstream [-changes into a source-] {+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-] {+using.+}
- whodepends: check which maintainers' packages depend on a [-package-] {+package.+}
{+ - who-permits-upload: Retrieve information about Debian Maintainer access+}
{+ control lists. [gnupg | gnupg2, libencode-locale-perl, libwww-perl,+}
{+ debian-keyring]+}
[-archive-]
{+archive.+} [gnupg | gnupg2, debian-keyring, debian-maintainers, wget]
- wnpp-alert: list installed packages which are orphaned or up for [-adoption-] {+adoption.+}
intention to package bug for a [-package-] {+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-] {+files.+}
[-.-]
[- Also included are a set-]
{+- /usr/share/doc/devscripts/examples: This directory contains examples+} of [-example mail filters-]
{+procmail and exim scripts+} for [-filtering-] {+sorting+} mail
[-from-] {+arriving to+} Debian
mailing [-lists using exim, procmail, etc.-] {+lists.+}