Bug#630224: grub-pc-bin: confusing package description

[Justin B Rye]

Package: grub-pc-bin
Version: 1.99-6
Severity: wishlist
Tags: patch

grub-pc-bin's long description describes what GRUB is, then to
explain how grub-pc-bin fits into the grub2 package family it says:

# This package contains a version of GRUB that has been built for use with
# traditional PC/BIOS architecture. It will not automatically install GRUB as
# the active boot loader, nor will it automatically update grub.cfg on upgrade,
# so most people should install grub-pc instead.

The first sentence is the same text as grub-pc's corresponding
paragraph, but the end of the second is a bit confusing - grub-pc has
a strict dependency on grub-pc-bin, so getting grub-pc installed
instead of grub-pc-bin isn't an option.  (Perhaps whoever wrote this
was thinking in terms of "most people should 'apt-get install grub-pc'
instead of starting from grub-pc-bin"?)

The relationship between grub-pc and grub-pc-bin is rather hard to
deduce from the package names and current descriptions - after all,
grub-pc-bin contains no normal executables in (s)bin directories,
while grub-pc has several.  Going by the explanations in
changelog.Debian.gz, I would suggest the following replacement text:

Package: grub-pc
Description: GRand Unified Bootloader, version 2 (PC/BIOS version)
 [...]
 This package will automatically install as the active boot loader a version
 of GRUB built for the traditional PC/BIOS architecture, and will automatically
 update grub.cfg on upgrade.

Package: grub-pc-bin
Description: GRand Unified Bootloader, version 2 (PC/BIOS modules)
 [...]
 This package contains a set of GRUB modules built for the traditional
 PC/BIOS architecture.  It can be installed in parallel with other flavors
 (for instance as build dependencies), but will not be set up as the active
 boot loader unless grub-pc is also installed.

...and so on for grub-yeeloong-bin etc.  I'm also standardising a couple
of inconsistent uses of "flavour" in the direction of the en_US spellings
used elsewhere, but not performing a full debian-l10n-english review.

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

Kernel: Linux 2.6.39-2-686-pae (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 grub-pc-bin depends on:
ii  grub-common                  1.99-6      GRand Unified Bootloader (common f
ii  libc6                        2.13-4      Embedded GNU C Library: Shared lib
ii  libdevmapper1.02.1           2:1.02.63-3 The Linux Kernel Device Mapper use

grub-pc-bin recommends no packages.

Versions of packages grub-pc-bin suggests:
pn  desktop-base                  <none>     (no description available)

-- no debconf information
-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: pd.diff
Type: text/x-diff
Size: 12214 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/pkg-grub-devel/attachments/20110612/75008a4d/attachment-0001.diff>