Package: procps
Version: 1:3.2.8-1
Severity: minor
Tags: patch

Every summer I run through the descriptions for high-priority and/or
high-popcon packages, looking for the ones that need any work.  Last
year I had this one down as not worth the effort of a bug report,
but this time round it's made it onto my list.

# Description: /proc file system utilities
#  These are utilities to browse the /proc filesystem, which is not a real file
#  system but a way for the kernel to provide information about the status of
#  entries in its process table. (e.g. running, stopped or "zombie")
#  Both command line and full screen utilities are provided. Ncurses is needed
#  for the full screen utilities.  More information can be found at procps
#  website http://procps.sf.net/
#  .
#  This package includes the following utilities: top, uptime, tload,
#  free, vmstat, watch, skill, pmap, pgrep, slabtop and pwdx.

Wishlist-level gripes:
 * procfs really is a file system (just not a writing-to-disk FS);
 * odd punctuation: period, open bracket, lowercase "e";
 * the Depends: line takes care of ncurses, no need to explain it;
 * add a "Harvard comma" in that list (just a matter of taste);
 * point at the homepage with a Homepage: line;

The one that makes this worth submitting as "Severity: minor":
 * that's a strangely selective contents catalogue - it omits kill,
        pkill, ps, snice, sysctl, and w!

My suggested replacement is:

 Homepage: http://procps.sf.net/
[...]
 Description: /proc file system utilities
  This package provides command line and full screen utilities for browsing
  procfs, a "pseudo" file system dynamically generated by the kernel to
  provide information about the status of entries in its process table
  (such as whether the process is running, stopped, or a "zombie").
  .
  It contains free, kill, pkill, pgrep, pmap, ps, pwdx, skill, slabtop,
  snice, sysctl, tload, top, uptime, vmstat, w, and watch.

Mind you, as with bsdutils (bug #482098), coreutils (#535458),
etcetera, I can't help feeling that the only sensible long-term
solution for contents-catalogues like this would be to maintain them
automatically via some sort of standard debhelper tool... 
-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
--- ../procps-3.2.8.pristine/debian/control	2009-07-05 03:11:48.000000000 +0100
+++ debian/control	2009-07-06 11:29:33.000000000 +0100
@@ -4,6 +4,7 @@
 Maintainer: Craig Small <[email protected]>
 Build-Depends: debhelper (>= 7), libncurses5-dev, make (>= 3.78.1-8), dpatch
 Standards-Version: 3.8.1
+Homepage: http://procps.sf.net/
 
 Package: procps
 Architecture: any
@@ -13,15 +14,13 @@
 Replaces: watch, bsdutils (<< 2.9x-1)
 Recommends: psmisc
 Description: /proc file system utilities
- These are utilities to browse the /proc filesystem, which is not a real file
- system but a way for the kernel to provide information about the status of
- entries in its process table. (e.g. running, stopped or "zombie")
- Both command line and full screen utilities are provided. Ncurses is needed
- for the full screen utilities.  More information can be found at procps
- website http://procps.sf.net/
+ This package provides command line and full screen utilities for browsing
+ procfs, a "pseudo" file system dynamically generated by the kernel to
+ provide information about the status of entries in its process table
+ (such as whether the process is running, stopped, or a "zombie").
  .
- This package includes the following utilities: top, uptime, tload,
- free, vmstat, watch, skill, pmap, pgrep, slabtop and pwdx.
+ It contains free, kill, pkill, pgrep, pmap, ps, pwdx, skill, slabtop,
+ snice, sysctl, tload, top, uptime, vmstat, w, and watch.
 
 Package: libproc-dev
 Architecture: any

Reply via email to