Your message dated Wed, 23 May 2012 21:12:41 +0000
with message-id <[email protected]>
and subject line Bug#673396: fixed in quota 4.00-4
has caused the Debian Bug report #673396,
regarding quota: package description suggestions
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.)


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

The package description for quotatool was mentioned on the
debian-l10n-english mailinglist (see #672848), which naturally brought
quota itself to my attention.  Looking at the control file:

> Package: quota
[...]
> Description: implementation of the disk quota system

The "implementation of" part is a waste of valuable space here - every
piece of software in Debian is necessarily an "implementation of"
something or other.  And besides, I'm not convinced that this package
is really an implementation of the disk quota system.  I would have
said it was the kernel module that implemented the quota system - this
package just provides a set of standard tools for managing quotas.

>  QUOTA is implemented using the BSD system call interface as the means of
>  communication with the user level. This is based on the Melbourne quota
>  system which uses both user and group quota files.

Policy 3.4 requires that "The description should describe the package
(the program) to a user (system administrator) who has never met it
before so that they have enough information to decide whether they
want to install it."  Even among Debian sysadmins who know all about
the developmental history of disk quota systems on UNIX it seems
unlikely that many of them set out to choose a quota manipulation tool
on the basis of whether or not it is based on something used at the
University of Melbourne back in the eighties.  So can we please leave
the ancient history to /usr/share/doc/quota/, and put something more
useful in the package description - for instance, an explanation of
what "disk quotas" are.

Compare the upstream web page at http://linuxquota.sourceforge.net/:

  _About_this_project:_ 

  This is the _Linux_DiskQuota_ project ("linuxquota")

  This project was registered on SourceForge.net on Jan 11, 2001, and
  is described by the project team as follows:

  Tools and patches for the Linux Diskquota system as part of the
  Linux kernel

The quota package description (with its reference to "QUOTA" as if
that was the canonical upstream name) is considerably older than this
Linux Diskquota project; indeed, it has hardly changed since 1996.

Maybe, cribbing from the material I've suggested for quotatool:

 Description: disk quota management tools
  This package provides the standard set of utilities for manipulating
  file system usage caps via the Linux Diskquota system. It can set hard
  or soft limits with adjustable grace periods on block or inode usage for
  users and groups. It allows users to check their quota status,
  integrates with LDAP, and supports quotas on remote machines via NFS.

Parts I'm unsure of:
 * should it mention supported file systems (e.g. XFS)?
 * exactly how integrated with LDAP is it, anyway?
 * are there any other parts I should be unsure of?
-- 
JBR     with qualifications in linguistics, experience as a Debian
        sysadmin, and probably no clue about this particular package
diff -ru quota-4.00.pristine/debian/control quota-4.00/debian/control
--- quota-4.00.pristine/debian/control	2012-05-14 12:01:16.000000000 +0100
+++ quota-4.00/debian/control	2012-05-14 13:57:01.487392503 +0100
@@ -12,7 +12,9 @@
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, debconf (>= 1.2.9) | debconf-2.0, lsb-base (>= 3.2-13)
 Suggests: libnet-ldap-perl, rpcbind | portmap,  default-mta | mail-transport-agent
-Description: implementation of the disk quota system
- QUOTA is implemented using the BSD system call interface as the means of
- communication with the user level. This is based on the Melbourne quota
- system which uses both user and group quota files.
+Description: disk quota management tools
+ This package provides the standard set of utilities for manipulating
+ file system usage caps via the Linux DiskQuota system. It can set hard
+ or soft limits with adjustable grace periods on block or inode usage for
+ users and groups. It allows users to check their quota status,
+ integrates with LDAP, and supports quotas on remote machines via NFS.

--- End Message ---
--- Begin Message ---
Source: quota
Source-Version: 4.00-4

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

quota_4.00-4.diff.gz
  to main/q/quota/quota_4.00-4.diff.gz
quota_4.00-4.dsc
  to main/q/quota/quota_4.00-4.dsc
quota_4.00-4_amd64.deb
  to main/q/quota/quota_4.00-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.
Michael Meskes <[email protected]> (supplier of updated quota 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: SHA1

Format: 1.8
Date: Wed, 23 May 2012 18:35:45 +0200
Source: quota
Binary: quota
Architecture: source amd64
Version: 4.00-4
Distribution: unstable
Urgency: low
Maintainer: Michael Meskes <[email protected]>
Changed-By: Michael Meskes <[email protected]>
Description: 
 quota      - disk quota management tools
Closes: 670641 673396
Changes: 
 quota (4.00-4) unstable; urgency=low
 .
   * Added upstream patch to fix problem with editing of several users.
     (Closes: #670641)
   * Updated packages description which was pretty outdated.
     Thanks to Justin B Rye <[email protected]> (Closes: #673396)
Checksums-Sha1: 
 0a152f76208acd6681a34542b583e6f8ee52e422 1165 quota_4.00-4.dsc
 9579277bbfeef28e1ad7448ebb01254dbeb35e7d 53806 quota_4.00-4.diff.gz
 d3a6850012fa7f0de31b228984fa103b681bccb3 620180 quota_4.00-4_amd64.deb
Checksums-Sha256: 
 3aae201b5b153ef7a4bd9af0ff725017c8e591dceaa46667312083e435756033 1165 
quota_4.00-4.dsc
 40856d310560deca6a784b6551f7d28cb5488a52a64ef3c35daf34ad91633956 53806 
quota_4.00-4.diff.gz
 38e8152f9d8418c0b9db3cc8ef7275ff65db09a0ba4e085f83bf9dc2001760e3 620180 
quota_4.00-4_amd64.deb
Files: 
 4acb4f6d129596331ab0e114ed616a2a 1165 admin optional quota_4.00-4.dsc
 e0d849de602c36e32577a3272b962ddb 53806 admin optional quota_4.00-4.diff.gz
 f84529d4b68120e4420493cecdfe4b16 620180 admin optional quota_4.00-4_amd64.deb

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

iD8DBQFPvRJzVkEm8inxm9ERAtWiAJ0YAG9bBihZUgOIyAbmPCnD5RPkzQCgiUQK
F/34DLvHDOk8ch+rmQ+z5mk=
=HqZX
-----END PGP SIGNATURE-----



--- End Message ---

Reply via email to