From f82c84c49c16d840f1790aa770a5105d2c7325f1 Mon Sep 17 00:00:00 2001
From: gmcgarry <gmcgarry@NetBSD.org>
Date: Wed, 20 Feb 2002 20:40:48 +0000
Subject: [PATCH] Explain why you'd use these functions.  Some formatting
 cleanup.

---
 lib/libarch/i386/i386_get_mtrr.2 | 35 +++++++++++++++++++++++---------
 1 file changed, 25 insertions(+), 10 deletions(-)

diff --git a/lib/libarch/i386/i386_get_mtrr.2 b/lib/libarch/i386/i386_get_mtrr.2
index 5d77f3546df3..578c7bcbe00b 100644
--- a/lib/libarch/i386/i386_get_mtrr.2
+++ b/lib/libarch/i386/i386_get_mtrr.2
@@ -1,4 +1,4 @@
-.\"     $NetBSD: i386_get_mtrr.2,v 1.5 2002/02/08 01:28:13 ross Exp $
+.\"     $NetBSD: i386_get_mtrr.2,v 1.6 2002/02/20 20:40:48 gmcgarry Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -53,7 +53,15 @@
 .Fn i386_set_mtrr "struct mtrr *mtrrp" "int *n"
 .Sh DESCRIPTION
 These functions provide an interface to the MTRR registers found on
-686-class processors.
+686-class processors for controlling processor access to memory ranges.
+This is most useful for accessing devices such as video accelerators
+on
+.Xr pci 4
+and
+.Xr agp 4
+busses.  For example, enabling write-combining allows bus-write transfers
+to be combined into a larger transfer before bursting over the bus.  This
+can increase performance of write operations 2.5 times or more. 
 .Pp
 .Fa mtrrp
 is a pointer to one or more mtrr structures, as described below. The
@@ -103,15 +111,15 @@ are:
 .Pp
 .Bl -tag -offset indent -width MTRR_TYPE_UNDEF1 -compact
 .It MTRR_TYPE_UC
-uncached memory.
+uncached memory
 .It MTRR_TYPE_WC
-use write-combining.
+use write-combining
 .It MTRR_TYPE_WT
-use write-through caching.
+use write-through caching
 .It MTRR_TYPE_WP
-write-protected memory.
+write-protected memory
 .It MTRR_TYPE_WB
-use write-back caching.
+use write-back caching
 .El
 .Pp
 Valid values for
@@ -120,11 +128,11 @@ are:
 .Pp
 .Bl -tag -offset indent -width MTRR_PRIVATE -compact
 .It MTRR_PRIVATE
-own range, reset the MTRR when the current process exits.
+own range, reset the MTRR when the current process exits
 .It MTRR_FIXED
-use fixed range MTRR.
+use fixed range MTRR
 .It MTRR_VALID
-entry is valid.
+entry is valid
 .El
 .Pp
 The
@@ -155,3 +163,10 @@ is invalid.
 .It Bq Er EBUSY
 No unused MTRRs are available.
 .El
+.Sh HISTORY
+The
+.Fn i386_get_mtrr
+and
+.Fn i386_set_mtrr
+functions appeared in
+.Nx 1.6 .