From sean@rand.tgd.net  Fri Jul 13 20:06:00 2001
Return-Path: <sean@rand.tgd.net>
Received: from mail.tgd.net (rand.tgd.net [64.81.67.117])
	by hub.freebsd.org (Postfix) with SMTP id CA93237B401
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 13 Jul 2001 20:05:59 -0700 (PDT)
	(envelope-from sean@rand.tgd.net)
Received: (qmail 31796 invoked from network); 14 Jul 2001 03:05:53 -0000
Received: from dsl081-067-239.sfo1.dsl.speakeasy.net (64.81.67.239)
  by rand.tgd.net with QMQP; 14 Jul 2001 03:05:53 -0000
Message-Id: <20010714030548.72991.qmail@wheel.tgd.net>
Date: 14 Jul 2001 03:05:48 -0000
From: Sean Chittenden <sean@chittenden.org>
Reply-To: Sean Chittenden <sean@chittenden.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc: sean@chittenden.org
Subject: nice(1) documentation incorrect
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         28958
>Category:       docs
>Synopsis:       nice(1) documentation incorrect
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 13 20:10:02 PDT 2001
>Closed-Date:    Sat Jul 14 01:44:55 PDT 2001
>Last-Modified:  Sat Jul 14 01:45:15 PDT 2001
>Originator:     Sean Chittenden
>Release:        FreeBSD 4.3-STABLE i386
>Organization:
>Environment:
System: FreeBSD wheel.tgd.net 4.3-STABLE FreeBSD 4.3-STABLE #0: Wed Jul 11 12:12:05 PDT 2001 sean@wheel.tgd.net:/usr/src/sys/compile/WHEEL i386


	
>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.
>How-To-Repeat:
	nice --20 date
>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.
>Release-Note:
>Audit-Trail:

From: Dima Dorfman <dima@unixfreak.org>
To: Sean Chittenden <sean@chittenden.org>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/28958: nice(1) documentation incorrect 
Date: Fri, 13 Jul 2001 23:14:44 -0700

 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`.

From: Sean Chittenden <sean@chittenden.org>
To: Dima Dorfman <dima@unixfreak.org>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/28958: nice(1) documentation incorrect
Date: Fri, 13 Jul 2001 23:21:49 -0700

 --jI8keyz6grp/JLjh
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 	Dough!  Good call.  I think it's time for a beer.  Thanks.  -sc
 
 > Sean Chittenden <sean@chittenden.org> writes:
 >=20
 > Please wrap lines at 72 characters.  Thanks.
 >=20
 > > >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.
 >=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`.
 
 --=20
 Sean Chittenden
 
 --jI8keyz6grp/JLjh
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Comment: Sean Chittenden <sean@chittenden.org>
 
 iEYEARECAAYFAjtP5P0ACgkQn09c7x7d+q21FACghsYXEeeCMmDlEOKuufdY2oq8
 hPoAnA5TWtj6laOHukJ485/ATdqJN5ef
 =LtC6
 -----END PGP SIGNATURE-----
 
 --jI8keyz6grp/JLjh--
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Sat Jul 14 01:44:55 PDT 2001 
State-Changed-Why:  
Originator was not using nice(1). 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=28958 
>Unformatted:
