Man page added.

4 files changed, 148 insertions, 2 deletions

diff --git a/sbin/comcontrol/Makefile b/sbin/comcontrol/Makefile
index 4617942..abc8d0a 100644
--- a/sbin/comcontrol/Makefile
+++ b/sbin/comcontrol/Makefile
@@ -1,6 +1,6 @@
 #	@(#)Makefile	5.4 (Berkeley) 6/5/91
 
 PROG=	comcontrol
-NOMAN= noman
+MAN8=   comcontrol.8
 
 .include <bsd.prog.mk>
diff --git a/sbin/comcontrol/comcontrol.8 b/sbin/comcontrol/comcontrol.8
new file mode 100644
index 0000000..4ecce67
--- /dev/null
+++ b/sbin/comcontrol/comcontrol.8
@@ -0,0 +1,73 @@
+.Dd December 10, 1993
+.Dt COMCONTROL 8
+.Os FreeBSD
+.Sh NAME
+.Nm comcontrol
+.Nd "control the bidirectional status of a sio port and waiting time after DTR drop"
+.Sh SYNOPSIS
+.Nm comcontrol
+.Ar sio_special_device
+.Op Cm bidir | Fl bidir
+.Op Cm dtrwait Ar ticks
+.Sh DESCRIPTION
+.Nm Comcontrol
+is used to examine and modify the bidirectional status
+of a specified
+sio communications port
+and its waiting time after DTR drop.
+By default (if
+.Ar sio_special_device
+only specified),
+.Nm comcontrol
+will print the current port state
+(if kernel was built with
+.Cm options COM_BIDIR )
+as either
+.Cm bidir
+to indicate that bidirectional operation is enabled or
+.Fl bidir
+to indicate that it is disabled, string
+.Cm dtrwait
+and current waiting time in ticks
+after DTR drop.
+To modify the status of the port or waiting time, simply
+specify the desired new state
+and/or new waiting time
+on the command line.  All users with
+read access to the
+.Ar sio_special_device
+can use
+.Nm comcontrol
+to get the port's status and current waiting time.
+Only root can set a port's status and waiting time.
+By default, each port is initially unidirectional, waiting time is 50 ticks.
+.Pp
+The standard way to use
+.Nm comcontrol
+is to put invocations of it in the
+.Ar /etc/rc.local
+startup script.
+.Sh SEE ALSO
+.Xr sio 4
+.Sh FILES
+.Bl -tag -width Pa
+.It Pa /dev/sio??
+.Sh DIAGNOSTICS
+.Cm TIOCMSBIDIR: Inappropriate ioctl for device.
+.Pp
+This indicates attempt to change port status on
+a non-sio special device file,
+or the kernel has not been built with
+.Cm options COM_BIDIR .
+For more information concerning reconfiguration
+of your kernel see
+.Ar /usr/src/sys/i386/doc/config_options.doc.
+.Sh AUTHOR
+Christopher G. Demetriou
+.Sh BUGS
+It is strongly recommended that you do *not*
+change the bidirectional status of a port while there are programs
+using the port.  Read that as: if you do, and it breaks, don't yell
+at me; that's a really weird thing to do.
+.Sh HISTORY
+Originally part of cgd's com package patches, version 0.2.1, to 386BSD 0.1.
diff --git a/sbin/i386/comcontrol/Makefile b/sbin/i386/comcontrol/Makefile
index 4617942..abc8d0a 100644
--- a/sbin/i386/comcontrol/Makefile
+++ b/sbin/i386/comcontrol/Makefile
@@ -1,6 +1,6 @@
 #	@(#)Makefile	5.4 (Berkeley) 6/5/91
 
 PROG=	comcontrol
-NOMAN= noman
+MAN8=   comcontrol.8
 
 .include <bsd.prog.mk>
diff --git a/sbin/i386/comcontrol/comcontrol.8 b/sbin/i386/comcontrol/comcontrol.8
new file mode 100644
index 0000000..4ecce67
--- /dev/null
+++ b/sbin/i386/comcontrol/comcontrol.8
@@ -0,0 +1,73 @@
+.Dd December 10, 1993
+.Dt COMCONTROL 8
+.Os FreeBSD
+.Sh NAME
+.Nm comcontrol
+.Nd "control the bidirectional status of a sio port and waiting time after DTR drop"
+.Sh SYNOPSIS
+.Nm comcontrol
+.Ar sio_special_device
+.Op Cm bidir | Fl bidir
+.Op Cm dtrwait Ar ticks
+.Sh DESCRIPTION
+.Nm Comcontrol
+is used to examine and modify the bidirectional status
+of a specified
+sio communications port
+and its waiting time after DTR drop.
+By default (if
+.Ar sio_special_device
+only specified),
+.Nm comcontrol
+will print the current port state
+(if kernel was built with
+.Cm options COM_BIDIR )
+as either
+.Cm bidir
+to indicate that bidirectional operation is enabled or
+.Fl bidir
+to indicate that it is disabled, string
+.Cm dtrwait
+and current waiting time in ticks
+after DTR drop.
+To modify the status of the port or waiting time, simply
+specify the desired new state
+and/or new waiting time
+on the command line.  All users with
+read access to the
+.Ar sio_special_device
+can use
+.Nm comcontrol
+to get the port's status and current waiting time.
+Only root can set a port's status and waiting time.
+By default, each port is initially unidirectional, waiting time is 50 ticks.
+.Pp
+The standard way to use
+.Nm comcontrol
+is to put invocations of it in the
+.Ar /etc/rc.local
+startup script.
+.Sh SEE ALSO
+.Xr sio 4
+.Sh FILES
+.Bl -tag -width Pa
+.It Pa /dev/sio??
+.Sh DIAGNOSTICS
+.Cm TIOCMSBIDIR: Inappropriate ioctl for device.
+.Pp
+This indicates attempt to change port status on
+a non-sio special device file,
+or the kernel has not been built with
+.Cm options COM_BIDIR .
+For more information concerning reconfiguration
+of your kernel see
+.Ar /usr/src/sys/i386/doc/config_options.doc.
+.Sh AUTHOR
+Christopher G. Demetriou
+.Sh BUGS
+It is strongly recommended that you do *not*
+change the bidirectional status of a port while there are programs
+using the port.  Read that as: if you do, and it breaks, don't yell
+at me; that's a really weird thing to do.
+.Sh HISTORY
+Originally part of cgd's com package patches, version 0.2.1, to 386BSD 0.1.