Improve package descriptions for dpkg, dpkg-dev and dselect

Thanks to Justin B Rye for the review and corrections. Closes: #484002

diff --git a/debian/changelog b/debian/changelog
index bf2aab8ed90d386c448edb6d46c9fe586cf9f92c..1c7cb3e62de3ecc20ab3f7086f9eebe35752b8ec 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -4,6 +4,8 @@ dpkg (1.14.20) UNRELEASED; urgency=low
   * Change UTF-8 '©' to '(C)' in deb-version.5 (unfuzzy translations).
   * Document --force-breaks in 'dpkg --force-help' output.
   * Document triggers --debug values in dpkg.1. Thanks to Sven Joachim.
+  * Improve package descriptions for dpkg, dpkg-dev and dselect.
+    Thanks to Justin B Rye for the review and corrections. Closes: #484002
 
   [ Raphael Hertzog ]
   * Add missing 'use File::Path' in Dpkg::Source::Package::V3::quilt.

diff --git a/debian/control b/debian/control
index c1ca9019a5748aa9b2b137c378966268dad529d5..38aac8d581de750d20bd85ed381688fe053c0fdd 100644 (file)
--- a/debian/control
+++ b/debian/control
@@ -23,12 +23,11 @@ Conflicts: sysvinit (<< 2.82-1), dpkg-iasearch (<< 0.11),
  dpkg-dev (<< 1.14.16), apt (<< 0.7.7), aptitude (<< 0.4.7-1)
 Replaces: manpages-de (<= 0.4-3), manpages-pl (<= 20051117-1)
 Suggests: apt, lzma
-Description: package maintenance system for Debian
- This package contains the low-level commands for handling the installation
- and removal of packages on your system.
+Description: Debian package management system
+ This package privides the low-level infrastructure for handling the
+ installation and removal of Debian software packages.
  .
- In order to unpack and build Debian source packages you will need to
- install the developers' package `dpkg-dev' as well as this one.
+ For Debian package development tools, install dpkg-dev.
 
 Package: dpkg-dev
 Section: utils
@@ -40,21 +39,21 @@ Recommends: gcc | c-compiler, build-essential
 Suggests: gnupg, debian-keyring
 Conflicts: dpkg-cross (<< 2.0.0), devscripts (<< 2.10.26)
 Replaces: manpages-pl (<= 20051117-1)
-Description: package building tools for Debian
- This package contains the tools (including dpkg-source) required to
- unpack, build and upload Debian source packages.
+Description: Debian package development tools
+ This package provides the development tools (including dpkg-source)
+ required to unpack, build and upload Debian source packages.
  .
- Most Debian source packages will require additional tools to build -
- for example, most packages need the `make' and the C compiler `gcc'.
+ Most Debian source packages will require additional tools to build;
+ for example, most packages need make and the C compiler gcc.
 
 Package: dselect
 Priority: optional
 Architecture: any
 Depends: ${shlibs:Depends}, dpkg (>= 1.13.1)
 Replaces: dpkg (<< 1.10.3)
-Description: user tool to manage Debian packages
- dselect is an interface for managing the installation and removal of
- packages on your system.
+Description: Debian package management front-end
+ dselect is a high-level interface for managing the installation and
+ removal of Debian software packages.
  .
  Many users find dselect intimidating and new users may prefer to use
- `apt'-based user interfaces.
+ apt-based user interfaces.