[src/trunk]: src/share/man/man4 Various improvements.

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

details:   https://anonhg.NetBSD.org/src/rev/6a9acba8f71f
branches:  trunk
changeset: 771631:6a9acba8f71f
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sat Nov 26 22:36:14 2011 +0000

description:
Various improvements.

diffstat:

 share/man/man4/vioif.4  |  10 +++++-----
 share/man/man4/viomb.4  |  20 ++++++++++++--------
 share/man/man4/virtio.4 |  14 +++++++-------
 3 files changed, 24 insertions(+), 20 deletions(-)

diffs (124 lines):

diff -r ca9eea04b5f3 -r 6a9acba8f71f share/man/man4/vioif.4
--- a/share/man/man4/vioif.4    Sat Nov 26 21:41:02 2011 +0000
+++ b/share/man/man4/vioif.4    Sat Nov 26 22:36:14 2011 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: vioif.4,v 1.1 2011/11/26 15:04:45 minoura Exp $
+.\"    $NetBSD: vioif.4,v 1.2 2011/11/26 22:36:14 wiz Exp $
 .\"
 .\" Copyright (C) 2011 Minoura Makoto.
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd
+.Dd November 26, 2011
 .Dt VIOIF 4
 .Os
 .Sh NAME
@@ -34,15 +34,15 @@
 .Cd "virtio* at pci? dev ? function ?"
 .Cd "vioif*  at virtio?"
 .Sh DESCRIPTION
-VirtIO
-defines an interface for efficient, standard and extensible I/O between the
+.Xr virtio 4
+defines an interface for efficient, standard, and extensible I/O between the
 hypervisor and the virtual machine.
 The
 .Nm
 driver supports virtio-compliant virtual network interface cards.
 .Sh SEE ALSO
+.Xr netintro 4 ,
 .Xr virtio 4 ,
-.Xr netinto 4 ,
 .Xr ifconfig 8
 .Rs
 .%A Rusty Russell, IBM Corporation
diff -r ca9eea04b5f3 -r 6a9acba8f71f share/man/man4/viomb.4
--- a/share/man/man4/viomb.4    Sat Nov 26 21:41:02 2011 +0000
+++ b/share/man/man4/viomb.4    Sat Nov 26 22:36:14 2011 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: viomb.4,v 1.1 2011/11/26 15:04:45 minoura Exp $
+.\"    $NetBSD: viomb.4,v 1.2 2011/11/26 22:36:14 wiz Exp $
 .\"
 .\" Copyright (C) 2011 Minoura Makoto.
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd
+.Dd November 26, 2011
 .Dt VIOMB 4
 .Os
 .Sh NAME
@@ -34,8 +34,10 @@
 .Cd "virtio* at pci? dev ? function ?"
 .Cd "viomb*  at virtio?"
 .Sh DESCRIPTION
-VirtIO defines an interface for efficient, standard and extensible I/O between
-the hypervisor and the virtual machine. The
+.Xr virtio 4
+defines an interface for efficient, standard, and extensible I/O between
+the hypervisor and the virtual machine.
+The
 .Nm
 driver supports the virtio-compliant memory ballooning device.
 .Pp
@@ -60,9 +62,11 @@
 allocated memory via VirtIO memory ballooning device.
 .El
 .Pp
-The sysctl node hw.viomb.npages shows the requested number of memory pages
-to return to the hypervisor, while hw.viomb.actual shows the actual
-number of memory pages that is already returned to the hypervisor.
+The sysctl node
+.Li hw.viomb.npages
+shows the requested number of memory pages to return to the hypervisor, while
+.Li hw.viomb.actual
+shows the actual number of memory pages that are already returned to the hypervisor.
 .Sh SEE ALSO
 .Xr virtio 4 ,
 .Xr sysctl 8
@@ -77,5 +81,5 @@
 .Nm
 device driver appeared in
 .Nx 6.0 .
-.Sh BUG
+.Sh BUGS
 The userland interface should be same as the Xen ballooning device.
diff -r ca9eea04b5f3 -r 6a9acba8f71f share/man/man4/virtio.4
--- a/share/man/man4/virtio.4   Sat Nov 26 21:41:02 2011 +0000
+++ b/share/man/man4/virtio.4   Sat Nov 26 22:36:14 2011 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: virtio.4,v 1.3 2011/11/26 15:04:45 minoura Exp $
+.\"    $NetBSD: virtio.4,v 1.4 2011/11/26 22:36:14 wiz Exp $
 .\"
 .\" Copyright (c) 2011 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -48,18 +48,18 @@
 driver itself provides the core infrastructure to communicate
 with the hypervisor (called virtqueues) and supports the following devices:
 .Bl -tag -width xxxxx
-.It Nm ld
+.It Xr ld 4
 A Disk device.
-.It Nm vioif
+.It Xr vioif 4
 An Ethernet device.
-.It Nm viomb
+.It Xr viomb 4
 A pseudo-device to release memory back to the hypervisor.
 .El
 .Sh SEE ALSO
+.Xr ld 4 ,
 .Xr pci 4 ,
-.Xr viomb 4 ,
-.Xr ld 4 ,
-.Xr vioif 4
+.Xr vioif 4 ,
+.Xr viomb 4
 .Pp
 .Rs
 .%A Rusty Russell, IBM Corporation