From 61d66690a5bb12a720383f10b1d9a1b8f840c726 Mon Sep 17 00:00:00 2001
From: Pádraig Brady <P@draigBrady.com>
Date: Thu, 22 Nov 2012 14:25:46 +0000
Subject: doc: clarify that renice is needed to adjust niceness

* doc/coreutils.texi (nice invocation): Ensure there is no
ambiguity in the summary in relation to nice being able
to adjust the niceness of an existing process.
Reference the renice command.
* man/nice.x: Reference renice (1)
---
 doc/coreutils.texi | 8 ++++++--
 man/nice.x         | 2 +-
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index cc9df7d43..166c41e23 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -15677,8 +15677,9 @@ the exit status of @var{command} otherwise
 @cindex scheduling, affecting
 @cindex appropriate privileges
 
-@command{nice} prints or modifies a process's @dfn{niceness},
-a parameter that affects whether the process is scheduled favorably.
+@command{nice} prints a process's @dfn{niceness}, or runs
+a command with modified niceness.  @dfn{niceness} affects how
+favorably the process is scheduled in the system.
 Synopsis:
 
 @example
@@ -15713,6 +15714,9 @@ built-in utilities}).
 
 @mayConflictWithShellBuiltIn{nice}
 
+Note to change the @dfn{niceness} of an existing process,
+one needs to use the @command{renice} command.
+
 The program accepts the following option.  Also see @ref{Common options}.
 Options must precede operands.
 
diff --git a/man/nice.x b/man/nice.x
index 3448d6997..952cb1073 100644
--- a/man/nice.x
+++ b/man/nice.x
@@ -3,4 +3,4 @@ nice \- run a program with modified scheduling priority
 [DESCRIPTION]
 .\" Add any additional description here
 [SEE ALSO]
-nice(2)
+nice(2), renice(1)
-- 
cgit v1.2.3-54-g00ecf