Bug 28958

Summary: nice(1) documentation incorrect
Product: Documentation Reporter: Sean Chittenden <seanc>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me CC: seanc
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Sean Chittenden freebsd_committer freebsd_triage 2001-07-14 04:10:02 UTC 
	The nice(1) man page seems to give incorrect usage of the command.  nice --20 doesn't yield a priority of -20 (gives error actually).  nice -20 give a niceness of -20.

Fix: 

Negative numbers are expressed as -number. Positive numbers are expressed as +number

	(in Examples:)

	nice -16 date

	I'd like to also see an example of a nice +20 command....

	nice +20 make

	Execute command  `make` at priority +20 so that normal user operations aren't disturbed as much.


	Maybe the `make` command should be replaced with setiathome or rc5 just to drive the point home.
How-To-Repeat: 	nice --20 date
Comment 1 dima 2001-07-14 07:14:44 UTC 
Sean Chittenden <sean@chittenden.org> writes:

Please wrap lines at 72 characters.  Thanks.

> >Description:
> 	The nice(1) man page seems to give incorrect usage of the
> command.  nice --20 doesn't yield a priority of -20 (gives error
> actually).  nice -20 give a niceness of -20.

I bet you're using csh, aren't you?  csh has a 'nice' builtin with a
completely differnet syntax than nice(1).  If you want to use the
latter's syntax (as properly described in its man page), you can
reference it as `/usr/bin/nice`.
Comment 2 Sean Chittenden freebsd_committer freebsd_triage 2001-07-14 07:21:49 UTC 
	Dough!  Good call.  I think it's time for a beer.  Thanks.  -sc

> Sean Chittenden <sean@chittenden.org> writes:
> 
> Please wrap lines at 72 characters.  Thanks.
> 
> > >Description:
> > 	The nice(1) man page seems to give incorrect usage of the
> > command.  nice --20 doesn't yield a priority of -20 (gives error
> > actually).  nice -20 give a niceness of -20.
> 
> I bet you're using csh, aren't you?  csh has a 'nice' builtin with a
> completely differnet syntax than nice(1).  If you want to use the
> latter's syntax (as properly described in its man page), you can
> reference it as `/usr/bin/nice`.


-- 
Sean Chittenden
Comment 3 dd freebsd_committer freebsd_triage 2001-07-14 09:44:55 UTC 
State Changed
From-To: open->closed

Originator was not using nice(1).