[src/trunk]: src/share/man/man9 Simplify macro usage.

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

details:   https://anonhg.NetBSD.org/src/rev/a25c136f5900
branches:  trunk
changeset: 1005414:a25c136f5900
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sat Dec 07 12:22:19 2019 +0000

description:
Simplify macro usage.

diffstat:

 share/man/man9/atomic_loadstore.9 |  14 +++++++-------
 share/man/man9/rnd.9              |   7 +++----
 2 files changed, 10 insertions(+), 11 deletions(-)

diffs (86 lines):

diff -r f1ade2290cc1 -r a25c136f5900 share/man/man9/atomic_loadstore.9
--- a/share/man/man9/atomic_loadstore.9 Sat Dec 07 11:45:45 2019 +0000
+++ b/share/man/man9/atomic_loadstore.9 Sat Dec 07 12:22:19 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: atomic_loadstore.9,v 1.3 2019/11/30 02:47:14 riastradh Exp $
+.\"    $NetBSD: atomic_loadstore.9,v 1.4 2019/12/07 12:22:19 wiz Exp $
 .\"
 .\" Copyright (c) 2019 The NetBSD Foundation
 .\" All rights reserved.
@@ -144,9 +144,9 @@
 For example, if a 32-bit word
 .Fa w
 is written with
-.Li atomic_store_relaxed(& Ns Fa w Ns Li "," 0x00010002) ,
+.Li atomic_store_relaxed ( & Ns Fa w , 0x00010002 ) ,
 then an interrupt, other thread, or other CPU reading it with
-.Li atomic_load_relaxed(& Ns Fa w Ns Li ")"
+.Li atomic_load_relaxed ( & Ns Fa w )
 will never witness it partially written, whereas
 .Fa w Li = 0x00010002
 might be compiled into a pair of separate 16-bit store instructions
@@ -600,9 +600,9 @@
 and
 .Fn WRITE_ONCE x v
 which are similar to
-.Li atomic_load_consume(& Ns Fa x Ns Li ")"
+.Li atomic_load_consume ( & Ns Fa x )
 and
-.Li atomic_store_relaxed(& Ns Fa x Ns Li "," Fa v Ns Li ")" ,
+.Li atomic_store_relaxed ( & Ns Fa x , Fa v ) ,
 respectively.
 However, while Linux's
 .Fn READ_ONCE
@@ -617,7 +617,7 @@
 to be aligned.
 .It
 They do not require
-.Li sizeof( Ns Fa x Ns Li ")"
+.Li sizeof ( Fa x )
 to be at most the largest size of available atomic loads and stores on
 the host architecture.
 .El
@@ -766,7 +766,7 @@
 operands of the
 .Li "&&" , "||" , "?:" ,
 and
-.Li ","
+.Li \&,
 operators and the
 .Fn kill_dependency
 macro, carry dependencies for which
diff -r f1ade2290cc1 -r a25c136f5900 share/man/man9/rnd.9
--- a/share/man/man9/rnd.9      Sat Dec 07 11:45:45 2019 +0000
+++ b/share/man/man9/rnd.9      Sat Dec 07 12:22:19 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: rnd.9,v 1.26 2019/12/04 03:04:43 riastradh Exp $
+.\"    $NetBSD: rnd.9,v 1.27 2019/12/07 12:26:05 wiz Exp $
 .\"
 .\" Copyright (c) 1997 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -78,7 +78,6 @@
 .Fa rnd_source ,
 for example with
 .Xr mutex 9 .
-.Pp
 .Bl -tag -width 8n
 .It Fn rndsource_setcb "krndsource_t *rnd_source" "void (*callback)(size_t, void *)" "void *cookie"
 This function sets a callback to be invoked when the kernel entropy
@@ -92,7 +91,7 @@
 .Fn rnd_attach_source
 in order for the callback to be used.
 The callback is invoked as
-.Fa callback Ns Li "(" Ns Fa nbytes Ns Li "," Fa cookie Ns Li ")" ,
+.Fa callback ( Fa nbytes , Fa cookie ) ,
 where
 .Fa nbytes
 is the number of bytes requested for the entropy pool, and
@@ -167,7 +166,7 @@
 towards the pool estimate)
 .Dv RND_FLAG_HASCB
 (caller specified a callback with
-.Fn rndsource_setcb Ns ).
+.Fn rndsource_setcb ) .
 For many devices,
 .Dv RND_FLAG_DEFAULT
 .Dv ( RND_FLAG_COLLECT_VALUE | RND_FLAG_COLLECT_TIME | RND_FLAG_ESTIMATE_TIME )