try to comply with our own recommendations on package synopsis;

improve the package descriptions

git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@2204 313b444b-1b9f-4f58-a734-7bb04f332e8d

diff --git a/debian/changelog b/debian/changelog
index d1c12d2750a47aef842762df555e540b9b570fe6..81a2bda21745a357c07ea4762555c40615676abc 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,7 +1,10 @@
 developers-reference (3.3.1) unstable; urgency=low
 
   * Josip Rodin:
-    - fixed package descriptions, closes: #182614
+    - package description said it contained French and Japanese, fixed,
+      closes: #182614
+  * Adam Di Carlo:
+    - more improvements to package synopsis and description
 
  -- Adam Di Carlo <aph@debian.org>
 

diff --git a/debian/control b/debian/control
index aa1a7bb7e7a3157be2a938b7914f053d74ab9381..b023731cff98c5dac843f15bcc1e5b1788ca7434 100644 (file)
--- a/debian/control
+++ b/debian/control
@@ -10,26 +10,31 @@ Package: developers-reference
 Architecture: all
 Recommends: debian-policy
 Suggests: doc-base
-Description: Debian Developer's Reference
+Description: guidelines and information for Debian developers
  This package contains the Debian Developer's Reference, a set of
- guidelines and best practices which has been established by for the
- community of Debian developers.
+ guidelines and best practices which has been established by and for
+ the community of Debian developers.  If you are not a Debian
+ developer, you probably do not need this package.
  .
  Table of Contents:
  .
  ${TOC:en}
  .
- This package contains the English version of the Developer's Reference.
- The Japanese and French translations are in separate packages now.
+ This package contains the English version of the Developer's
+ Reference.  The Japanese translation is available in
+ developers-reference-ja and the French translation is available in
+ developers-reference-fr.
 
 Package: developers-reference-fr
 Architecture: all
 Recommends: debian-policy
 Suggests: doc-base
-Description: Debian Developer's Reference, French version
+Description: guidelines and information for Debian developers, in French
  This package contains the French translation of Debian Developer's
- Reference, a set of guidelines and best practices which has been
- established by for the community of Debian developers.
+ Reference (package: developers-reference), a set of guidelines and
+ best practices which has been established by and for the community of
+ Debian developers.  If you are not a Debian developer, you probably
+ do not need this package.
  .
  Table of Contents (in English):
  .
@@ -39,10 +44,12 @@ Package: developers-reference-ja
 Architecture: all
 Recommends: debian-policy
 Suggests: doc-base
-Description: Debian Developer's Reference, Japanese version
+Description: guidelines and information for Debian developers, in Japanese
  This package contains the Japanese translation of Debian Developer's
- Reference, a set of guidelines and best practices which has been
- established by for the community of Debian developers.
+ Reference (package: developers-reference), a set of guidelines and
+ best practices which has been established by and for the community of
+ Debian developers.  If you are not a Debian developer, you probably
+ do not need this package.
  .
  Table of Contents (in English):
  .