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)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index cc9df7d431c79d7606d592fa86d4c146db73d492..166c41e239c09ffd1d3f44212c4c8bade526ded7 100644 (file)
--- 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 3448d6997f69d912f53d3e324bc8047efb9f6aa6..952cb10730b85f9c60c2e310b30984367484a492 100644 (file)
--- 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)