Your message dated Wed, 06 Jul 2011 16:49:40 +0200
with message-id <[email protected]>
and subject line Re: Bug#480204: Bug #480204: Fixed in Texinfo manual but not
in man page
has caused the Debian Bug report #480204,
regarding coreutils: man page of 'nice' hard to understand
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.)
--
480204: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=480204
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: coreutils
Version: 5.97-5.3
Severity: normal
The man page of the command 'nice' is very hard to understand. At least
for non-native speakers of English.
The explanation of what a positive or respectively negative value actually
means is given as:
"Nicenesses range from -20 (most favorable scheduling) to 19 (least
favorable)."
To me it is not clear what is exactly meant by favorable and, more importantly,
for whom it is favorable. Favorable for the process that is niced or
favorable for the other running processes.
It would be much clearer if the man page contained a description like this:
"Nicenesses range from -20 (process has high priority and gets more
resources, thus slowing down other processes) to 19 (process has low priority
and runs slow itself but has less impact on the speed of other running
processes)."
-- System Information:
Debian Release: 4.0
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/bash
Kernel: Linux 2.6.18-6-k7
Locale: LANG=de_DE@euro, LC_CTYPE=de_DE@euro (charmap=ISO-8859-15)
Versions of packages coreutils depends on:
ii libacl1 2.2.41-1 Access control list shared library
ii libc6 2.7-10 GNU C Library: Shared libraries
ii libselinux1 1.32-3 SELinux shared libraries
coreutils recommends no packages.
-- no debconf information
²
--- End Message ---
--- Begin Message ---
Benoît Knecht wrote:
> This was actually fixed upstream [1] and released in version 6.12, but
> only the Texinfo manual was changed. The man page, which is generated
> from the output of 'nice --help', still has the old wording.
>
> [1]
> http://git.savannah.gnu.org/cgit/coreutils.git/commit/?id=0fe9fc4558194fa5c0083ecb7330ee1d28792777
>
> I would suggest closing the bug nonetheless; the man page points to the
> Texinfo manual for more information, and it seems better to keep the
> output of 'nice --help' short. Thoughts?
Thanks for the triage.
I agree, so have marked this "done".
If anyone disagrees, they're welcome to reopen.
--- End Message ---
