Package: coreutils
Version: 6.10-6
Severity: normal

The manpage for id does not describe what information it prints.  It
should state that by default, the information printed is the username
and userid, default/current group name and group id, and the list of
groups (and the group ids) to which that user belongs, instead of merely
stating "Without any OPTION, print some useful set of identified [sic]
information."

The description should be changed from "Print information for USERNAME,
or the current user." to "Print information about the user and groups
for the user specified by USERNAME, or the current user if USERNAME is
not specified."

A user who has never heard of id should be able to determine how to
properly use it by looking solely at the manual page.  In its current
state, that's apparently not the case; hence, this bug.

If you specify whether you'd like the manpage in man, mdoc, or DocBook
5.0 format, I'll happily provide you with a non-autogenerated manpage
with useful information.

My client, who pointed out the lack of information, is in X-Debbugs-CC.

-- System Information:
Debian Release: 5.0
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.28-1-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) (ignored: LC_ALL 
set to en_US.UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages coreutils depends on:
ii  libacl1                       2.2.47-2   Access control list shared library
ii  libc6                         2.7-18     GNU C Library: Shared libraries
ii  libselinux1                   2.0.65-5   SELinux shared libraries

coreutils recommends no packages.

coreutils suggests no packages.

-- no debconf information

--
brian m. carlson / brian with sandals: Houston, Texas, US
+1 713 440 7475 | http://crustytoothpaste.ath.cx/~bmc | My opinion only
troff on top of XML: http://crustytoothpaste.ath.cx/~bmc/code/thwack
OpenPGP: RSA v4 4096b 88AC E9B2 9196 305B A994 7552 F1BA 225C 0223 B187

Attachment: signature.asc
Description: Digital signature

Reply via email to