Package: bird
Version: 1.2.5-1
Severity: wishlist

The short descriptions for bird and bird6 are identical:

  Description: Internet Routing Daemon

Only on comparing the long descriptions closely does it become clear
that bird is IPv4-only whereas bird6 is IPv6-only.  You may think
this is obvious from the package-names, but compare, say, drupal6,
grace6, or indeed libc6 in the dependencies below, where it's just a
version number.  Users looking for either kind of routing daemon
(especially if they don't expect the functionality to be split
between two packages) are likely to be led up the garden path; this
could easily be avoided by differentiating the package synopses.

But once I'm editing the control file, I find myself obliged to
suggest a lot more changes:

 Bird is an internet routing daemons which manages TCP/IP based routing
            I                      ✗               ✗✗✗✗✗✗✗✗✗✗✗✗
 protocols with full support of all modern routing protocols. Bird is easy to
                                ???          [repetitive]          ??
 use configuration interface and powerful route filtering language.
 .
 It supports IPv4 versions OSPFv2, RIPv2 (No v1), BGP and redistribution between
                     ?       [nb no OSPFv1]
 the protocols with a powerful configuration syntax.
  [misplaced - this doesn't vary between bird and bird6]

I would suggest something like:

 Description: Internet Routing Daemon for IPv{4,6}
  BIRD is a daemon for managing Internet routing, with full support of
  all the major routing protocols. It allows redistribution between
  protocols, with a powerful route filtering syntax and an easy-to-use
  configuration interface.
  .
  This package supports IPv{4,6} versions of OSPF (v{2,3}), RIP ({v2,ng}), and 
BGP.

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

Kernel: Linux vmlinuz-2.6.32-5-686 (SMP w/1 CPU core)
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 bird depends on:
ii  libc6                     2.11.2-7       Embedded GNU C Library: Shared lib
ii  libncurses5               5.7+20100313-4 shared libraries for terminal hand
ii  libreadline6              6.1-3          GNU readline and history libraries

Versions of packages bird recommends:
pn  bird6                         <none>     (no description available)

bird suggests no packages.

-- no debconf information

-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
--- ../bird-1.2.5.pristine/debian/control	2010-11-14 14:16:40.000000000 +0000
+++ debian/control	2010-11-14 15:12:37.000000000 +0000
@@ -10,27 +10,23 @@
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Conflicts: zebra, routed
 Recommends: bird6
-Description: Internet Routing Daemon
- Bird is an internet routing daemons which manages TCP/IP based
- routing protocols with full support of all modern routing
- protocols. Bird is easy to use configuration interface and powerful
- route filtering language.
+Description: Internet Routing Daemon for IPv4
+ BIRD is a daemon for managing Internet routing, with full support of
+ all the major routing protocols. It allows redistribution between
+ protocols, with a powerful route filtering syntax and an easy-to-use
+ configuration interface.
  .
- It supports IPv4 versions OSPFv2, RIPv2 (No v1), BGP and
- redistribution between the protocols with a powerful configuration
- syntax.
+ This package supports IPv4 versions of OSPF (v2), RIP (v2), and BGP.
 
 Package: bird6
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Conflicts: zebra, routed
 Recommends: bird
-Description: Internet Routing Daemon
- Bird is an internet routing daemons which manages TCP/IP based
- routing protocols with full support of all modern routing
- protocols. Bird is easy to use configuration interface and powerful
- route filtering language.
+Description: Internet Routing Daemon for IPv6
+ BIRD is a daemon for managing Internet routing, with full support of
+ all the major routing protocols. It allows redistribution between
+ protocols, with a powerful route filtering syntax and an easy-to-use
+ configuration interface.
  .
- It supports IPv6 versions of OSPFv3, RIPv2 (No v1), BGP and
- redistribution between the protocols with a powerful configuration
- syntax.
+ This package supports IPv6 versions of OSPF (v3), RIP (ng), and BGP.

Reply via email to