From nobody@FreeBSD.org  Wed Jun 11 09:20:56 2008
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id AC3B4106567C
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 11 Jun 2008 09:20:56 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id A07838FC23
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 11 Jun 2008 09:20:56 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m5B9Ku0t039704
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 11 Jun 2008 09:20:56 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.2/8.14.1/Submit) id m5B9KuPs039703;
	Wed, 11 Jun 2008 09:20:56 GMT
	(envelope-from nobody)
Message-Id: <200806110920.m5B9KuPs039703@www.freebsd.org>
Date: Wed, 11 Jun 2008 09:20:56 GMT
From: Ighighi <ighighi@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: incomplete nice(1) manpage
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         124469
>Category:       docs
>Synopsis:       incomplete nice(1) manpage
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    remko
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jun 11 09:30:01 UTC 2008
>Closed-Date:    Sat Feb 26 11:28:59 UTC 2011
>Last-Modified:  Sat Feb 26 11:28:59 UTC 2011
>Originator:     Ighighi
>Release:        6.3-STABLE
>Organization:
>Environment:
FreeBSD 6.3-STABLE #0: Wed Jun  4 15:18:20 VET 2008
>Description:
There's no mention of the range of available nice values...  Not even
a pointer to the nice(3) manpage to supplement it.
>How-To-Repeat:

>Fix:
I suggest adding this sentence present in NetBSD's nice(1):

"The priority can be adjusted over a range of -20 (the highest) to
20 (the lowest)."

See:
http://cvsweb.netbsd.org/bsdweb.cgi/src/usr.bin/nice/nice.1

Also, a pointer to nice(3) would be ok.
We may also use renice(8) which is a lot more complete.

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->remko 
Responsible-Changed-By: remko 
Responsible-Changed-When: Thu Jun 12 10:53:37 UTC 2008 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=124469 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/124469: commit references a PR
Date: Thu, 24 Feb 2011 16:13:38 +0000 (UTC)

 Author: remko
 Date: Thu Feb 24 16:13:33 2011
 New Revision: 219003
 URL: http://svn.freebsd.org/changeset/base/219003
 
 Log:
   Add wording about the priority range and
   mention what effect this has at certain
   values.
   
   PR:		124469
   Obtained from:	NetBSD nice.1 v1.14
   MFC after:	1 week
 
 Modified:
   head/usr.bin/nice/nice.1
 
 Modified: head/usr.bin/nice/nice.1
 ==============================================================================
 --- head/usr.bin/nice/nice.1	Thu Feb 24 14:56:12 2011	(r219002)
 +++ head/usr.bin/nice/nice.1	Thu Feb 24 16:13:33 2011	(r219003)
 @@ -28,7 +28,7 @@
  .\"	@(#)nice.1	8.1 (Berkeley) 6/6/93
  .\" $FreeBSD$
  .\"
 -.Dd June 6, 1993
 +.Dd February 24, 2011
  .Dt NICE 1
  .Os
  .Sh NAME
 @@ -50,6 +50,11 @@ value by the specified
  .Ar increment ,
  or a default value of 10.
  The lower the nice value of a process, the higher its scheduling priority.
 +.Ar increment .
 +The priority can be adjusted over a range of -20 (the higest) to 20 (the
 +lowest).
 +A priority of 19 or 20 will prevent a process from taking any cycles from
 +others at nice 0 or better.
  .Pp
  The superuser may specify a negative increment in order to run a utility
  with a higher scheduling priority.
 @@ -107,6 +112,7 @@ option has been deprecated but is still 
  .Xr rtprio 1 ,
  .Xr getpriority 2 ,
  .Xr setpriority 2 ,
 +.Xr nice 3,
  .Xr renice 8
  .Sh STANDARDS
  The
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->patched 
State-Changed-By: remko 
State-Changed-When: Thu Feb 24 16:21:37 UTC 2011 
State-Changed-Why:  
This had been committed to -head 

http://www.freebsd.org/cgi/query-pr.cgi?pr=124469 
State-Changed-From-To: patched->closed 
State-Changed-By: remko 
State-Changed-When: Sat Feb 26 11:28:31 UTC 2011 
State-Changed-Why:  
This is not accurate and is thus reverted. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=124469 
>Unformatted:
