diff --git a/share/man/man4/irframe.4 b/share/man/man4/irframe.4
index a94e378afe8c..f91a560e3bd9 100644
--- a/share/man/man4/irframe.4
+++ b/share/man/man4/irframe.4
@@ -1,4 +1,4 @@
-.\" $NetBSD: irframe.4,v 1.4 2001/12/03 23:23:47 augustss Exp $
+.\" $NetBSD: irframe.4,v 1.5 2001/12/04 23:29:14 augustss Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -43,6 +43,8 @@
 .Sh SYNOPSIS
 .Cd "irframe* at oboe?"
 .Cd "pseudo-device irframetty"
+.Pp
+.Cd "#include <dev/irdaio.h>"
 .Sh DESCRIPTION
 The
 .Nm
@@ -51,6 +53,29 @@ It does not contain the IrDA protocol stack per se, but the stack
 can be built on top of the
 .Nm
 driver.
+.Pp
+Access to frames is via the
+.Xr read 2
+and
+.Xr write 2
+system calls.  Each write constitutes one frame, and each read yields one frame.
+The
+.Xr poll 2
+system call can be used to check for availability of frames.
+There are also a number of
+.Xr ioctl 2
+calls to manipulate the device:
+.Bl -tag -width xxxxxx
+.It Dv IRDA_RESET_PARAMS
+Reset the parameters set by
+.Dv IRDA_SET_PARAMS .
+.It Dv IRDA_SET_PARAMS Fa "(struct irda_params)"
+Set the speed, extra beginning of frame bytes, and maximum frame size.
+.It Dv IRDA_GET_SPEEDMASK Fa (int)
+Get the set of allowable speeds.
+.It Dv IRDA_GET_TURNAROUNDMASK Fa (int)
+Get the set of allowable turn around times.
+.El
 .Sh SEE ALSO
 .Xr cir 4 ,
 .Xr irframetty 4 ,
@@ -64,7 +89,3 @@ The
 driver
 appeared in
 .Nx 1.6 .
-.Sh BUGS
-This man page lacks a description of the device API.
-.Pp
-There is no access to IrDA devices via ttys.
diff --git a/share/man/man4/irframetty.4 b/share/man/man4/irframetty.4
index e2ea9d8e7efe..bd7dfd22c770 100644
--- a/share/man/man4/irframetty.4
+++ b/share/man/man4/irframetty.4
@@ -1,4 +1,4 @@
-.\" $NetBSD: irframetty.4,v 1.1 2001/12/03 23:23:47 augustss Exp $
+.\" $NetBSD: irframetty.4,v 1.2 2001/12/04 23:29:14 augustss Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -42,6 +42,8 @@
 .Nd IrDA frame over serial line driver
 .Sh SYNOPSIS
 .Cd "pseudo-device irframetty"
+.Pp
+.Cd "#include <dev/irdaio.h>"
 .Sh DESCRIPTION
 The
 .Nm
@@ -53,6 +55,21 @@ via an IrDA dongle.
 Access to the frames is via the
 .Xr irframe 4
 driver.
+.Pp
+Different dongles require different handling.
+The connected dongle type can be set with
+.Xr ioctl 2
+calls:
+.Bl -tag -width xxxxxx
+.It Dv IRFRAMETTY_SET_DONGLE Fa (int)
+Set the dongle type.  See the include file for possible dongles.
+.It Dv IRFRAMETTY_GET_DONGLE Fa (int)
+Get the dongle type.
+.It Dv IRFRAMETTY_GET_DEVICE Fa (int)
+Get the number of the
+.Xr irframe 4
+device that must be used to access the frames.
+.El
 .Sh SEE ALSO
 .Xr irframe 4
 .Sh HISTORY
@@ -61,5 +78,3 @@ The
 driver
 appeared in
 .Nx 1.6 .
-.Sh BUGS
-This man page is incomplete.