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.+}

Merge request reports

Loading