Package: perl-base
Version: 5.10.0-10
Severity: minor
Tags: patch

I've been going through Essential looking for package descriptions
that were in need of a review.  This one's the very last on my
"Severity: minor" list (see #482098, #482666, #458029, #483023,
#483221, #484002, #484172, #484547).

# Package: perl-base
# Description: The Pathologically Eclectic Rubbish Lister
#  A scripting language with delusions of full language-hood, Perl is used
#  in many system scripts and utilities.
#  .
#  This is a stripped down Perl with only essential libraries.  To make
#  full use of Perl, you'll want to install the `perl', `perl-modules' and
#  optionally `perl-doc' packages which supplement this one.

Issues:
* Capitalised article in synopsis (discouraged in DevRef).
* Unhelpful synopsis.  There's nothing wrong with humour in a
        package description (if #144193 was right then the first
        line of the long description would have to go as well), but
        Policy on synopsis lines does say to "make it as informative
        as you can".
* Slightly too personal; what I want isn't relevant (if company
        policy demands a full Perl system, I'm forced to install
        "perl", whether I like it or not).
* The only extra package I need to ask for is perl, which "Depends:
        perl-modules" and "Recommends: perl-doc".

Here's a suggestion that fixes all those and has spacing and quotes
standardised to match the debian-l10n-english house style:
                           
 Description: minimal Perl system
  Perl, the Pathologically Eclectic Rubbish Lister, is a scripting
  language with delusions of full language-hood, used in many system
  scripts and utilities.
  .
  This package provides a stripped down Perl with only essential
  libraries. For the full standard set, install "perl" (and its
  dependencies).

-- System Information:
Debian Release: lenny/sid
  APT prefers testing
  APT policy: (500, 'testing'), (50, 'unstable')
Architecture: i386 (i586)

Kernel: Linux 2.6.25.custom
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages perl-base depends on:
ii  libc6                         2.7-10     GNU C Library: Shared libraries

perl-base recommends no packages.

-- no debconf information
-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
diff -ur perl-5.10.0.pristine/debian/control perl-5.10.0/debian/control
--- perl-5.10.0.pristine/debian/control	2008-06-03 17:51:13.000000000 +0100
+++ perl-5.10.0/debian/control	2008-06-03 17:54:08.000000000 +0100
@@ -16,13 +16,14 @@
 Replaces: perl (<= 5.10.0-9), perl-modules (<< 5.8.8-8), libperl5.8 (<< 5.8.0-20), libscalar-list-utils-perl, libclass-multimethods-perl (<< 1.70-4), libxsloader-perl 
 Provides: perl5-base, ${perlapi:Provides}, libscalar-list-utils-perl, libxsloader-perl
 Suggests: perl
-Description: The Pathologically Eclectic Rubbish Lister
- A scripting language with delusions of full language-hood, Perl is used
- in many system scripts and utilities.
+Description: minimal Perl system
+ Perl, the Pathologically Eclectic Rubbish Lister, is a scripting
+ language with delusions of full language-hood, used in many system
+ scripts and utilities.
  .
- This is a stripped down Perl with only essential libraries.  To make
- full use of Perl, you'll want to install the `perl', `perl-modules' and
- optionally `perl-doc' packages which supplement this one.
+ This package provides a stripped down Perl with only essential
+ libraries. For the full standard set, install "perl" (and its
+ dependencies).
 
 Package: libcgi-fast-perl
 Priority: optional

Reply via email to