mdoc(7) police: markup overhaul.

1 files changed, 29 insertions, 26 deletions

diff --git a/share/man/man4/ng_h4.4 b/share/man/man4/ng_h4.4
index bc76e1c..606e272 100644
--- a/share/man/man4/ng_h4.4
+++ b/share/man/man4/ng_h4.4
@@ -1,8 +1,6 @@
-.\" ng_h4.4
-.\" 
 .\" Copyright (c) 2001-2002 Maksim Yevmenkin <m_evmenkin@yahoo.com>
 .\" All rights reserved.
-.\" 
+.\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
@@ -11,7 +9,7 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
-.\" 
+.\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -23,15 +21,15 @@
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
-.\" 
-.\" $Id: ng_h4.4,v 1.3 2002/11/12 17:10:13 max Exp $
+.\"
 .\" $FreeBSD$
+.\"
 .Dd June 14, 2002
 .Dt NG_H4 4
 .Os
 .Sh NAME
-.Nm h4
-.Nd Netgraph node type that is also a H4 line discipline
+.Nm ng_h4
+.Nd Netgraph node type that is also an H4 line discipline
 .Sh SYNOPSIS
 .In sys/types.h
 .In sys/ttycom.h
@@ -39,20 +37,22 @@
 .In netgraph/ng_h4.h
 .Sh DESCRIPTION
 The
-.Nm
-node type is both a persistent Netgraph node type and a H4 line 
-discipline. It implements a Bluetooth HCI UART transport layer as 
-per chapter H4 of the Bluetooth Specification Book v1.1. A new 
-node is created when the corresponding line discipline,
+.Nm h4
+node type is both a persistent Netgraph node type and a H4 line
+discipline.
+It implements a Bluetooth HCI UART transport layer as
+per chapter H4 of the Bluetooth Specification Book v1.1.
+A new node is created when the corresponding line discipline,
 .Dv H4DISC ,
 is registered on a tty device (see
 .Xr tty 4 ) .
 .Pp
 The node has a single hook called
 .Dv hook .
-Incoming bytes received on the tty device are re-assembled into 
-HCI frames (according to the length). Full HCI frames are sent out on 
-the hook. HCI frames received on
+Incoming bytes received on the tty device are re-assembled into
+HCI frames (according to the length).
+Full HCI frames are sent out on the hook.
+HCI frames received on
 .Dv hook
 are transmitted out on the tty device.
 No modification to the data is performed in either direction.
@@ -65,22 +65,22 @@ Information about the node is available via the netgraph
 command
 .Dv NGIOCGINFO .
 This command returns a
-.Dv "struct nodeinfo"
+.Vt "struct nodeinfo"
 similar to the
 .Dv NGM_NODEINFO
-netgraph control message.
+.Xr netgraph 4
+control message.
 .Sh HOOKS
 This node type supports the following hooks:
-.Pp
-.Bl -tag -width foobar
+.Bl -tag -width indent
 .It Dv hook
 single HCI frame contained in single
-.Dv mbuf
+.Vt mbuf
 structure.
 .El
 .Sh CONTROL MESSAGES
 This node type supports the generic control messages, plus the following:
-.Bl -tag -width foo
+.Bl -tag -width indent
 .It Dv NGM_H4_NODE_RESET
 Reset the node.
 .It Dv NGM_H4_NODE_GET_STATE
@@ -96,8 +96,8 @@ Returns current length of outgoing queue for the node.
 This command takes an integer argument and sets maximum length of
 outgoing queue for the node.
 .It Dv NGM_H4_NODE_GET_STAT
-Returns various statistic information for the node, such as: number of 
-bytes (frames) sent, number of bytes (frames) received and number of 
+Returns various statistic information for the node, such as: number of
+bytes (frames) sent, number of bytes (frames) received and number of
 input (output) errors.
 .It Dv NGM_H4_NODE_RESET_STAT
 Reset all statistic counters to zero.
@@ -106,7 +106,10 @@ Reset all statistic counters to zero.
 This node shuts down when the corresponding device is closed
 (or the line discipline is uninstalled on the device).
 .Sh BUGS
-This node still uses spltty() to lock tty layer. This is wrong.
+This node still uses
+.Xr spltty 9
+to lock tty layer.
+This is wrong.
 .Sh SEE ALSO
 .Xr ioctl 2 ,
 .Xr netgraph 4 ,
@@ -114,7 +117,7 @@ This node still uses spltty() to lock tty layer. This is wrong.
 .Xr ngctl 8
 .Sh HISTORY
 The
-.Nm
+.Nm h4
 node type was implemented in
 .Fx 5.0 .
 .Sh AUTHORS