From ccf0fdd5d122ae5ffb46392906972aec6b417ef7 Mon Sep 17 00:00:00 2001
From: jruoho <jruoho@NetBSD.org>
Date: Mon, 17 May 2010 20:25:19 +0000
Subject: [PATCH] Briefly describe and note also struct bintime.

---
 share/man/man3/timeval.3     | 22 ++++++++++++++++++++--
 share/man/man9/microtime.9   |  6 ++++--
 share/man/man9/microuptime.9 |  6 ++++--
 3 files changed, 28 insertions(+), 6 deletions(-)

diff --git a/share/man/man3/timeval.3 b/share/man/man3/timeval.3
index f57557187dc1..1e4de31a8613 100644
--- a/share/man/man3/timeval.3
+++ b/share/man/man3/timeval.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: timeval.3,v 1.3 2010/05/17 12:27:13 jruoho Exp $
+.\" $NetBSD: timeval.3,v 1.4 2010/05/17 20:25:19 jruoho Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -129,8 +129,26 @@ If
 .Va it_value
 is non-zero, it indicates the time left to the next timer expiration.
 A value zero implies that the timer is disabled.
-.El
+.It
+The following structure is used by
+.Xr microtime 9 ,
+among others:
+.Bd -literal -offset indent
+struct bintime {
+	time_t		sec;
+	uint64_t	frac;
+};
+.Ed
 .Pp
+The
+.Va sec
+member specifies the time in seconds and the
+.Va frac
+represents 64-bit fraction of seconds.
+The
+.Va struct bintime
+is meant to be used in the kernel only.
+.El
 .Sh STANDARDS
 These structures conform to
 .St -p1003.1-2004 .
diff --git a/share/man/man9/microtime.9 b/share/man/man9/microtime.9
index 3cb65b78c98a..3c27aa062a6f 100644
--- a/share/man/man9/microtime.9
+++ b/share/man/man9/microtime.9
@@ -1,4 +1,4 @@
-.\"     $NetBSD: microtime.9,v 1.15 2008/11/28 10:55:41 tsutsui Exp $
+.\"     $NetBSD: microtime.9,v 1.16 2010/05/17 20:25:19 jruoho Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -53,7 +53,7 @@
 .\"
 .\" $FreeBSD: src/share/man/man9/microtime.9,v 1.11 2005/10/13 16:01:28 jhb Exp $
 .\"
-.Dd November 24, 2008
+.Dd May 17, 2010
 .Dt MICROTIME 9
 .Os
 .Sh NAME
@@ -112,6 +112,8 @@ and
 .Fn getnanotime
 functions store the time as a
 .Vt "struct timespec" .
+The structures are described in
+.Xr timeval 3 .
 .Pp
 The
 .Fn bintime ,
diff --git a/share/man/man9/microuptime.9 b/share/man/man9/microuptime.9
index e41f3086aa9a..3c21c915df87 100644
--- a/share/man/man9/microuptime.9
+++ b/share/man/man9/microuptime.9
@@ -1,4 +1,4 @@
-.\" $NetBSD: microuptime.9,v 1.8 2008/11/28 10:52:22 tsutsui Exp $
+.\" $NetBSD: microuptime.9,v 1.9 2010/05/17 20:25:19 jruoho Exp $
 .\"
 .\" Copyright (c) 2000 Kelly Yancey
 .\" All rights reserved.
@@ -26,7 +26,7 @@
 .\"
 .\" $FreeBSD: src/share/man/man9/microuptime.9,v 1.7 2005/01/12 21:48:25 ru Exp $
 .\"
-.Dd November 24, 2008
+.Dd May 17, 2010
 .Dt MICROUPTIME 9
 .Os
 .Sh NAME
@@ -73,6 +73,8 @@ and
 .Fn getnanouptime
 functions store the elapsed time as a
 .Vt "struct timespec" .
+These structures are described in
+.Xr timeval 3 .
 .Pp
 The
 .Fn binuptime ,