Bug 55837

Summary: nice: man pages incorrect (4.8,5.0&5.1)
Product: Documentation Reporter: Christian Wittenhorst <wiwi>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Christian Wittenhorst 2003-08-21 14:50:20 UTC
        Man pages for nice(1) incorrect/outdated.

        SYNOPSIS
                nice [-n increment] utility [argument ...]

        ...

                EXAMPLES
                        Execute utility `date' at priority 5 assuming the priority of the shell
                        is 0:        

                        nice -n 5 date

        nice(1) only accepts nice +n ... (to increase niceness) or nice -n (to decrease). The samples provides do not work

How-To-Repeat:         yellow:/home/sysadm/wiwi%  nice -n 5 date
        nice: Badly formed number.
Comment 1 Simon L. B. Nielsen freebsd_committer freebsd_triage 2003-08-21 14:57:39 UTC
On 2003.08.21 13:42:20 +0000, Christian Wittenhorst wrote:
> 
> >Number:         55837
> >Category:       docs
> >Synopsis:       nice: man pages incorrect (4.8,5.0&5.1)
> >How-To-Repeat:
>         yellow:/home/sysadm/wiwi%  nice -n 5 date
>         nice: Badly formed number.


Which shell are you using?  Most shells have their own version of nice
with different syntax than nice(1). e.g. :

[simon@arthur:~] nice -n 10 echo Hello
nice: Badly formed number.
[simon@arthur:~] /usr/bin/nice -n 10 echo Hello
Hello
[simon@arthur:~] nice +10 echo Hello
Hello

From nice(1) :

     Some shells may provide a builtin nice command which is similar or iden-
     tical to this utility.  Consult the builtin(1) manual page.

It think this is what you are seeing.

-- 
Simon L. Nielsen
FreeBSD Documentation Team
Comment 2 Christian Brueffer freebsd_committer freebsd_triage 2003-08-30 23:47:46 UTC
State Changed
From-To: open->feedback

Waiting for feedback from the submitter
Comment 3 Christian Wittenhorst 2003-08-31 11:15:17 UTC
--On Thursday, August 21, 2003 15:57 +0200 "Simon L. Nielsen" 
<simon@FreeBSD.org> wrote:

> On 2003.08.21 13:42:20 +0000, Christian Wittenhorst wrote:
>>
>> > Number:         55837
>> > Category:       docs
>> > Synopsis:       nice: man pages incorrect (4.8,5.0&5.1)
>> > How-To-Repeat:
>>         yellow:/home/sysadm/wiwi%  nice -n 5 date
>>         nice: Badly formed number.
>
> Which shell are you using?  Most shells have their own version of nice
> with different syntax than nice(1). e.g. :

Of course you are right. What a stupid mistake. I thought to use sh but 
actually used bash in fact. Sorry for the troubles!

Best regards,

	wiwi

-- 
c. wittenhorst, progon network engineering
haldenstrasse 6, ch-6300 zug, switzerland
phone: +41 79 4603040, fax: +41 41 7807318
Comment 4 Simon L. B. Nielsen freebsd_committer freebsd_triage 2003-09-03 22:30:46 UTC
State Changed
From-To: feedback->closed

The submitter has confirmed that the problem was the built-in nice 
commands from the shell, so close the PR.