[src/trunk]: src/share/man/man9 Sort sections. Fix typo. Remove superfluous Pp.

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c0f902bf0609
branches:  trunk
changeset: 455556:c0f902bf0609
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sat Apr 06 07:56:49 2019 +0000

description:
Sort sections. Fix typo. Remove superfluous Pp.

diffstat:

 share/man/man9/ucas.9 |  26 ++++++++++++--------------
 1 files changed, 12 insertions(+), 14 deletions(-)

diffs (68 lines):

diff -r 9e8a9cd863f3 -r c0f902bf0609 share/man/man9/ucas.9
--- a/share/man/man9/ucas.9     Sat Apr 06 07:56:19 2019 +0000
+++ b/share/man/man9/ucas.9     Sat Apr 06 07:56:49 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ucas.9,v 1.3 2019/04/06 03:06:24 thorpej Exp $
+.\"    $NetBSD: ucas.9,v 1.4 2019/04/06 07:56:49 wiz Exp $
 .\"
 .\" Copyright (c) 2019 Jason R. Thorpe.
 .\" Copyright (c) 2011 YAMAMOTO Takashi,
@@ -52,7 +52,6 @@
 Except that they can be safely used for the kernel to access user-space
 address, they are semantically equivalents of
 .Xr atomic_cas 3 .
-.Pp
 .Bl -tag -width uptr
 .It Fa uptr
 The pointer to the variable.
@@ -65,16 +64,6 @@
 The pointer to the memory to store the old value of the variable.
 .El
 .\" ------------------------------------------------------------
-.Sh RETURN VALUES
-On success, these functions return 0.
-In that case, the caller can consult the value returned via
-.Fa retp
-to check the result of the CAS operation.
-Otherwise, these functions return an appropriate
-.Xr errno 9
-error code, typically
-.Dv EFAULT .
-.\" ------------------------------------------------------------
 .Sh IMPLEMENTATION NOTES
 The
 .Nm ucas
@@ -87,7 +76,6 @@
 the implementation and are not to be called by consumers of the
 .Nm ucas
 API:
-.Pp
 .Bl -tag -width _ucas_32
 .It Ft int Fn _ucas_32 \
 "volatile uint32_t *uptr" "uint32_t old" "uint32_t new" "uint32_t *retp" ;
@@ -139,7 +127,7 @@
 and the multiprocessor implementation synchronizes with other CPUs using
 interprocessor interrupts.
 .Pp
-If a particular platform wishes ro use the generic implementation on
+If a particular platform wishes to use the generic implementation on
 uniprocessors but an optimized implementation on multiprocessors, the
 the platform should define
 .Dv __HAVE_UCAS_MP
@@ -155,6 +143,16 @@
 platform
 .Pc .
 .\" ------------------------------------------------------------
+.Sh RETURN VALUES
+On success, these functions return 0.
+In that case, the caller can consult the value returned via
+.Fa retp
+to check the result of the CAS operation.
+Otherwise, these functions return an appropriate
+.Xr errno 9
+error code, typically
+.Dv EFAULT .
+.\" ------------------------------------------------------------
 .Sh SEE ALSO
 .Xr atomic_cas 3 ,
 .Xr intro 9