[src/trunk]: src/share/man/man4 Improve wording, use more macros.

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

details:   https://anonhg.NetBSD.org/src/rev/8eb7ff74e681
branches:  trunk
changeset: 953445:8eb7ff74e681
user:      wiz <wiz%NetBSD.org@localhost>
date:      Tue Mar 09 12:02:24 2021 +0000

description:
Improve wording, use more macros.

diffstat:

 share/man/man4/ixg.4 |  18 ++++++++++--------
 share/man/man4/ixv.4 |  18 ++++++++++--------
 2 files changed, 20 insertions(+), 16 deletions(-)

diffs (72 lines):

diff -r 176496bd137e -r 8eb7ff74e681 share/man/man4/ixg.4
--- a/share/man/man4/ixg.4      Tue Mar 09 10:03:18 2021 +0000
+++ b/share/man/man4/ixg.4      Tue Mar 09 12:02:24 2021 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: ixg.4,v 1.13 2021/03/09 10:03:18 msaitoh Exp $
+.\" $NetBSD: ixg.4,v 1.14 2021/03/09 12:02:24 wiz Exp $
 .\"
 .\" Copyright (c) 2001-2008, Intel Corporation
 .\" All rights reserved.
@@ -89,17 +89,19 @@
 driver doesn't use the common
 .Xr MCLGET 9
 interface and use the driver specific cluster allocation mechanism.
-If it's exhausted,
+If it's exhausted, the
 .Xr evcnt 9
-counter "ixgX qY Rx no jumbo mbuf" is incremented. If it's observed,
-The number can be changed by the following config parameter:
+counter "ixgX qY Rx no jumbo mbuf" is incremented.
+If this is observed,
+the number can be changed by the following config parameter:
 .Bl -tag -width IXGBE_JCLNUM_MULTI -offset 3n
 .It Dv IXGBE_JCLNUM_MULTI
-The number of RX jumbo buffer (cluster) per queue is calculated by
+The number of RX jumbo buffers (clusters) per queue is calculated by
 .Dv IXGBE_JCLNUM_MULTI
-* (number of rx descriptor).
-The total number of clusters per queue is available with
-hw.ixgN.num_jcl_per_queue sysctl.
+* (number of rx descriptors).
+The total number of clusters per queue is available via the
+.Li hw.ixgN.num_jcl_per_queue
+.Xr sysctl 7 .
 .El
 .Sh SEE ALSO
 .Xr arp 4 ,
diff -r 176496bd137e -r 8eb7ff74e681 share/man/man4/ixv.4
--- a/share/man/man4/ixv.4      Tue Mar 09 10:03:18 2021 +0000
+++ b/share/man/man4/ixv.4      Tue Mar 09 12:02:24 2021 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ixv.4,v 1.6 2021/03/09 10:03:18 msaitoh Exp $
+.\"    $NetBSD: ixv.4,v 1.7 2021/03/09 12:02:24 wiz Exp $
 .\"
 .\" Copyright (c) 2018 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -49,17 +49,19 @@
 driver doesn't use the common
 .Xr MCLGET 9
 interface and use the driver specific cluster allocation mechanism.
-If it's exhausted,
+If it's exhausted, the
 .Xr evcnt 9
-counter "ixgX qY Rx no jumbo mbuf" is incremented. If it's observed,
-The number can be changed by the following config parameter:
+counter "ixgX qY Rx no jumbo mbuf" is incremented.
+If this is observed,
+the number can be changed by the following config parameter:
 .Bl -tag -width IXGBE_JCLNUM_MULTI -offset 3n
 .It Dv IXGBE_JCLNUM_MULTI
-The number of RX jumbo buffer (cluster) per queue is calculated by
+The number of RX jumbo buffers (clusters) per queue is calculated by
 .Dv IXGBE_JCLNUM_MULTI
-* (number of rx descriptor).
-The total number of clusters per queue is available with
-hw.ixgN.num_jcl_per_queue sysctl.
+* (number of rx descriptors).
+The total number of clusters per queue is available with the
+.Li hw.ixgN.num_jcl_per_queue
+.Xr sysctl 7 .
 .El
 .Sh SEE ALSO
 .Xr arp 4 ,