Followup-For: Bug #506578
Package: sg3-utils
Version: 1.24-2
Tags: patch
Noel Köthe wrote:
> the description talks about the obsolent kernels 2.2 and 2.4 but Debian
> ships 2.6 so people are interested in 2.6 information.
> The mentioned sg-utils is not available anymore.
It’s true that the references to kernel/driver/package versions are
all just distracting irrelevancies now, but I thought I'd follow up
this bugreport to say that it’s worse than that — the description
contains a piece of significant misinformation:
# This driver is only found in 2.4.x Linux kernels; […]
# In the 2.6 series other device names may be used as well
# (e.g. /dev/sda).
Clearly, this blurb has been modified for 2.6; but that update left
unchanged the claim that the package is useful only with Linux 2.4
(and therefore useless on Lenny). That seems more than a “minor”
bug… but far more important than assessing the severity is coming up
with a fix — commented pseudopatch follows, raw patch attached.
-Description: Utilities for working with generic SCSI devices
+Description: utilities for working with generic SCSI devices
Lowercasing “utilities” is all that's needed to make it perfectly
compliant with DevRef guidelines. Likewise for the other members of
this source package.
- This package includes a number of utilities to manipulate the Linux "sg"
- (version 3) device driver.
- .
- This driver is only found in 2.4.x Linux kernels; if you are using
- 2.2 (or earlier), please install the sg-utils package instead. In
- the 2.4 series SCSI generic device names (e.g. /dev/sg0) must be
- used. In the 2.6 series other device names may be used as well
- (e.g. /dev/sda).
- .
- The package includes a number of utilities to allow a user to use the sg
- interface to find out low-level information about any SCSI device.
Throw out paragraph two, merge the rest to give:
+ This package includes a number of utilities to manipulate the Linux
+ SCSI generic ("sg") device driver, giving access to low-level
+ information about any SCSI device.
.
It also includes source code for some example programs that demonstrate
- how to use the scsi generic driver.
+ how to use the sg driver.
I've moved the explanation of SG to the start rather than having it
implicit in the final sentence.
Mind you, given that there's a libsgutils1-dev, why are these .c
files going into the end-user sg3-utils package?
--
JBR
Ankh kak! (Ancient Egyptian blessing)
--- ../sg3-utils.old/debian/control 2008-12-06 21:08:21.000000000 +0000
+++ debian/control 2008-12-06 21:14:10.000000000 +0000
@@ -10,21 +10,13 @@
Depends: ${shlibs:Depends}
Conflicts: sg-utils, cdwrite
Replaces: sg-utils
-Description: Utilities for working with generic SCSI devices
- This package includes a number of utilities to manipulate the Linux "sg"
- (version 3) device driver.
- .
- This driver is only found in 2.4.x Linux kernels; if you are using
- 2.2 (or earlier), please install the sg-utils package instead. In
- the 2.4 series SCSI generic device names (e.g. /dev/sg0) must be
- used. In the 2.6 series other device names may be used as well
- (e.g. /dev/sda).
- .
- The package includes a number of utilities to allow a user to use the sg
- interface to find out low-level information about any SCSI device.
+Description: utilities for working with generic SCSI devices
+ This package includes a number of utilities to manipulate the Linux
+ SCSI generic ("sg") device driver, giving access to low-level
+ information about any SCSI device.
.
It also includes source code for some example programs that demonstrate
- how to use the scsi generic driver.
+ how to use the sg driver.
Package: libsgutils1
Section: libs
@@ -32,7 +24,7 @@
Conflicts: libsgutils-1-0
Architecture: any
Recommends: sg3-utils
-Description: Utilities for working with generic SCSI devices (shared libraries)
+Description: utilities for working with generic SCSI devices (shared libraries)
This package contains shared libraries that allow programs to use the sg
interface to query SCSI devices.
@@ -41,7 +33,7 @@
Architecture: any
Depends: libsgutils1, ${shlibs:Depends}
Recommends: sg3-utils
-Description: Utilities for working with generic SCSI devices (developer files)
+Description: utilities for working with generic SCSI devices (developer files)
This package contains the <scsi/sg_cmds.h> and <scsi/sg_lib.h> header
files, the /usr/lib/libsgutils.a static library and other assorted
development tidbits.
