Your message dated Fri, 11 Mar 2011 17:25:09 +0000
with message-id <[email protected]>
and subject line Bug#614146: fixed in udisks 1.0.2-4
has caused the Debian Bug report #614146,
regarding udisks: obfuscatory package description
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)


-- 
614146: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=614146
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: udisks
Version: 1.0.1+git20100614-3
Severity: wishlist
Tags: patch

The package description for udisks is unnecessarily jargon-heavy.
It's easy for a non-GNOME desktop not to include any packages that
declare a dependency on udisks, and a user looking for software to
install manually is offered no incentive by the current description.

 Description: abstraction for enumerating block devices
 
The package is not an "abstraction", and the executables it contains
are useful for a lot more than "enumerating block devices" - that
sounds like a job for "find /dev -type b | nl"!

  udisks is an abstraction for enumerating block devices and performing
  operations on them. Any application can access the
  org.freedesktop.UDisks service on the system message bus.
  Some operations (such as formatting disks etc.) are restricted using 
PolicyKit.

This is sadly lacking in the sort of information that Debian Policy
3.4 says "should" be present in a package description  - the users
reading it are supposed to be able to tell what benefits the software
offers to them, not to applications on buses!

I would suggest starting from scratch with something more like:

 Description: storage media interface
  The udisks daemon serves as an interface to system block devices,
  implemented via D-Bus. It handles operations such as querying, mounting,
  unmounting, formatting, or detaching storage devices such as hard disks
  or USB thumb drives.
  .
  This package also provides the udisks utility, which can be used to
  trigger these operations from the command line (if permitted by
  PolicyKit). External tools such as hdparm are used if available to
  implement extra operations, such as configuring disk spindown times.

(That would also go some way towards closing bug #595114, though that
might require a more detailed list than I can provide.)

While I'm editing this control file, the udisks-doc package can use:

 Description: storage media interface - documentation
  The udisks daemon serves as an interface to system block devices,
  implemented via D-Bus. It handles operations such as querying, mounting,
  unmounting, formatting, or detaching storage devices such as hard disks
  or USB thumb drives.
  .
  This package provides the API reference and manuals in devhelp format.

(That should be enough to make it clear that there's no extra user
documentation here, and indeed nothing that's easily accessible if you
don't happen to have the right specialised API-browser installed.)

-- System Information:
Debian Release: 6.0
  APT prefers stable
  APT policy: (500, 'stable'), (200, 'squeeze-updates')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-5-amd64 (SMP w/2 CPU cores)
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 udisks depends on:
ii  dbus                  1.2.24-4           simple interprocess messaging syst
ii  libatasmart4          0.17+git20100219-2 ATA S.M.A.R.T. reading and parsing
ii  libc6                 2.11.2-10          Embedded GNU C Library: Shared lib
ii  libdbus-1-3           1.2.24-4           simple interprocess messaging syst
ii  libdbus-glib-1-2      0.88-2.1           simple interprocess messaging syst
ii  libdevmapper1.02.1    2:1.02.48-5        The Linux Kernel Device Mapper use
ii  libglib2.0-0          2.24.2-1           The GLib library of C routines
ii  libgudev-1.0-0        164-3              GObject-based wrapper library for 
ii  libparted0debian1     2.3-5              The GNU Parted disk partitioning s
ii  libpolkit-backend-1-0 0.96-4             PolicyKit backend API
ii  libpolkit-gobject-1-0 0.96-4             PolicyKit Authorization API
ii  libsgutils2-2         1.29-1             utilities for devices using the SC
ii  libudev0              164-3              libudev shared library
ii  udev                  164-3              /dev/ and hotplug management daemo

Versions of packages udisks recommends:
ii  dosfstools                  3.0.9-1      utilities for making and checking 
ii  hdparm                      9.32-1       tune hard disk parameters for high
ii  mtools                      4.0.12-1     Tools for manipulating MSDOS files
pn  ntfs-3g                     <none>       (no description available)
pn  ntfsprogs                   <none>       (no description available)
ii  policykit-1                 0.96-4       framework for managing administrat

Versions of packages udisks suggests:
pn  cryptsetup                    <none>     (no description available)
pn  mdadm                         <none>     (no description available)
pn  reiserfsprogs                 <none>     (no description available)
pn  xfsprogs                      <none>     (no description available)

-- no debconf information

-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
diff -ru udisks-1.0.1+git20100614.pristine/debian/control udisks-1.0.1+git20100614/debian/control
--- udisks-1.0.1+git20100614.pristine/debian/control	2010-09-27 17:57:26.000000000 +0100
+++ udisks-1.0.1+git20100614/debian/control	2011-02-19 21:33:07.172925542 +0000
@@ -38,11 +38,16 @@
 Breaks: libgdu0 (<< 2.28), libgdu-gtk0 (<< 2.28)
 Conflicts: devicekit-disks
 Replaces: devicekit-disks
-Description: abstraction for enumerating block devices
- udisks is an abstraction for enumerating block devices and performing
- operations on them. Any application can access the
- org.freedesktop.UDisks service on the system message bus.
- Some operations (such as formatting disks etc.) are restricted using PolicyKit.
+Description: storage media interface
+ The udisks daemon serves as an interface to system block devices,
+ implemented via D-Bus. It handles operations such as querying, mounting,
+ unmounting, formatting, or detaching storage devices such as hard disks
+ or USB thumb drives.
+ .
+ This package also provides the udisks utility, which can be used to
+ trigger these operations from the command line (if permitted by
+ PolicyKit). External tools such as hdparm are used if available to
+ implement extra operations, such as configuring disk spindown times.
 
 Package: udisks-doc
 Architecture: all
@@ -51,9 +56,10 @@
 Suggests: devhelp
 Conflicts: devicekit-disks-doc
 Replaces: devicekit-disks-doc
-Description: abstraction for enumerating block devices - documentation
- udisks is an abstraction for enumerating block devices and performing
- operations on them. Any application can access the
- org.freedesktop.UDisks service on the system message bus.
- Some operations (such as formatting disks etc.) are restricted using PolicyKit.
-
+Description: storage media interface - documentation
+ The udisks daemon serves as an interface to system block devices,
+ implemented via D-Bus. It handles operations such as querying, mounting,
+ unmounting, formatting, or detaching storage devices such as hard disks
+ or USB thumb drives.
+ .
+ This package provides the API reference and manuals in devhelp format.

--- End Message ---
--- Begin Message ---
Source: udisks
Source-Version: 1.0.2-4

We believe that the bug you reported is fixed in the latest version of
udisks, which is due to be installed in the Debian FTP archive:

udisks-doc_1.0.2-4_all.deb
  to main/u/udisks/udisks-doc_1.0.2-4_all.deb
udisks_1.0.2-4.debian.tar.gz
  to main/u/udisks/udisks_1.0.2-4.debian.tar.gz
udisks_1.0.2-4.dsc
  to main/u/udisks/udisks_1.0.2-4.dsc
udisks_1.0.2-4_amd64.deb
  to main/u/udisks/udisks_1.0.2-4_amd64.deb



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to [email protected],
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Martin Pitt <[email protected]> (supplier of updated udisks package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [email protected])


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Format: 1.8
Date: Fri, 11 Mar 2011 18:08:40 +0100
Source: udisks
Binary: udisks udisks-doc
Architecture: source amd64 all
Version: 1.0.2-4
Distribution: unstable
Urgency: low
Maintainer: Utopia Maintenance Team 
<[email protected]>
Changed-By: Martin Pitt <[email protected]>
Description: 
 udisks     - storage media interface
 udisks-doc - storage media interface - documentation
Closes: 595114 614146
Changes: 
 udisks (1.0.2-4) unstable; urgency=low
 .
   * 02-defer_smart_probing.patch: Try SMART probing again repeatedly while the
     daemon is inhibited. (LP: #580112)
   * Add 00git-udf-permissions.patch: Ignore broken directory permissions on
     UDF when they are on readonly CD media. (LP: #635499)
   * debian/control: Improve package description. Thanks Justin B Rye!
     (Closes: #614146)
   * debian/control: Explain in the package description why udisks
     recommends/suggests file system creation/admin tools. (Closes: #595114)
   * Activate support for udisks-tcp-bridge. Note that this is purely
     convenience and does not enable extra privileges (can do the same with ssh
     and dbus-send). This unbreaks the "Connect to server.." functionality in
     gnome-disk-utility. (LP: #568926)
     - debian/rules: Drop --disable-remote-access.
     - debian/udisks.install: Install Avahi service description file.
   * Add debian/patches/00git-sd-card-id.patch: Add missing rule for
     identifying SD card readers as such. (LP: #460713)
Checksums-Sha1: 
 25e94c97d62083c75a312888ffdbe73503810fee 2356 udisks_1.0.2-4.dsc
 6f60ebcab70b52574ae1cddd96d68209d7470629 19866 udisks_1.0.2-4.debian.tar.gz
 2fafd42b3185381d8517f1f074ce15edec65cc0c 261642 udisks_1.0.2-4_amd64.deb
 e3a87064096c0a425fad54c16fd3440135fd5234 71714 udisks-doc_1.0.2-4_all.deb
Checksums-Sha256: 
 047b2efde7df00049442e63e094f98e8e86327e9164c3d61ac7ac05514ba3fd6 2356 
udisks_1.0.2-4.dsc
 ecb898b5b70290d6c06ac7a0bc26c3ee2e5d94c765f959907d53c959b18984dd 19866 
udisks_1.0.2-4.debian.tar.gz
 392b9e886634584e0b25bba31618452ff9b76a521980ce211d8e2a819af78ff5 261642 
udisks_1.0.2-4_amd64.deb
 1d538bfa065069f1110e6554f2b2ac3fb9d7b8d4cdf5deb97cfb989828da0cb7 71714 
udisks-doc_1.0.2-4_all.deb
Files: 
 172b52d6fa7b3a10354da321fffbcb1d 2356 admin optional udisks_1.0.2-4.dsc
 6a1f602ba10fe59e0b3cebb0d43bb629 19866 admin optional 
udisks_1.0.2-4.debian.tar.gz
 1a127ac820e5c60f7b77d2afabaf5f21 261642 admin optional udisks_1.0.2-4_amd64.deb
 096d8ba47b3a619b4d4eccd61b8adc5c 71714 doc optional udisks-doc_1.0.2-4_all.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)

iQIcBAEBCAAGBQJNelewAAoJEPmIJawmtHufCOwP/0OFguwtyoB0KrAY4ZI2DhnS
j1QKR4jDCaaYtFY2dwh8AJcK1QuVB0rfpJ7sQapXoeetAaZio7oQsL0h/Li/29fn
SdBc0RnOJtEdgQElH9ujODnohsmed6DaqoHaqd560+oWbzj0utqgE3prgRKp5uM/
BaENo+wCyyOPTOnnxvyoKYpLCMGoJmqoKkTiZV6xsL5X1LskSmr+5tgm30QZnTXB
PDCtimBli3pCyuRZAUmyebMC6tWzYU2CPaut/r1NAj9R5a7ZBlWN57oP7No6Dkyv
XmfjumnTlPmkZD0Zonacv4bArkubEp0qf5hwbE5770nXmmjpDBteSQDGIDlq8BOQ
xws1tKEXpGjC9L2EVyk0duX6oVAqdpPdOmTUPSlrRjFFuele+pOrA6RjFSL7+sx8
THNVfS7z+HVhmuOcL244gVTo67xIqyO3Zw1EhnjTRgj5nlnLrbidXiE1uolEZkM3
qAeZQ4YeYUTIAraGrEdw6O+FUrpoy82LBCnfOpBGCR8Fyaf1YS3ZnXrNgSwDEMdj
7+7qNhdbH3AUSfDMZD+nFa0VYcYEliWIoRFZD5FDlXJ7e/z5vjB3AEve7l2hjQX1
XseLYB7avGSmNpWCpHq7dgmzMiDdW4o2G1AUmzisYMV5febaxj/udOJrgYP/BSEM
C2cnDt+EyPxW7nJaVhsh
=KgqV
-----END PGP SIGNATURE-----



--- End Message ---

Reply via email to