nice.2: Move discussion of handling the -1 success return to RETURN VALUE

This detail was rather hidden in NOTES. Also, rework the text
a little.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/nice.2 b/man2/nice.2
index 2b2fe3a4f9d2cdc9613222ac11f206a2d5c98520..913937a1173a07f689fe5a848794ac6b4e5b44b1 100644 (file)
--- a/man2/nice.2
+++ b/man2/nice.2
@@ -68,6 +68,13 @@ On success, the new nice value is returned (but see NOTES below).
 On error, \-1 is returned, and
 .I errno
 is set appropriately.
+
+A successful call can legitimately return \-1.
+To detect an error, set
+.I errno
+to 0 before the call, and check whether it is nonzero after
+.BR nice ()
+returns \-1.
 .SH ERRORS
 .TP
 .B EPERM
@@ -113,13 +120,6 @@ Since glibc 2.2.4, the
 wrapper function provided by glibc provides conformance to POSIX.1 by calling
 .BR getpriority (2)
 to obtain the new nice value, which is then returned to the caller.
-With this implementation,
-a successful call can legitimately return \-1.
-To reliably detect an error, set
-.I errno
-to 0 before the call, and check its value when
-.BR nice ()
-returns \-1.
 .SH SEE ALSO
 .BR nice (1),
 .BR renice (1),