From fe394d06b6a1bbc33e4d20e94a99b7d057c4cbd2 Mon Sep 17 00:00:00 2001
From: eeh <eeh@NetBSD.org>
Date: Thu, 28 Mar 2002 18:22:20 +0000
Subject: [PATCH] Explicitly document previously undocumented (and changed)
 semantics of pmap_clear_reference and pmap_clear_modify.

---
 share/man/man9/pmap.9 | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/share/man/man9/pmap.9 b/share/man/man9/pmap.9
index 91a6eea3d7fd..97e4e2acdffa 100644
--- a/share/man/man9/pmap.9
+++ b/share/man/man9/pmap.9
@@ -1,4 +1,4 @@
-.\"	$NetBSD: pmap.9,v 1.12 2002/02/13 08:18:48 ross Exp $
+.\"	$NetBSD: pmap.9,v 1.13 2002/03/28 18:22:20 eeh Exp $
 .\"
 .\" Copyright (c) 2000, 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -308,7 +308,19 @@ be cleared is when the virtual memory system explicitly calls the
 .Fn pmap_clear_modify
 and
 .Fn pmap_clear_reference
-functions.
+functions.  These functions also need to do whatever is necessary
+to restart the collection of state information for that page, 
+including possibly calling
+.Fn pmap_page_protect
+if the 
+.Nm
+is doing modified/referenced emulation.
+.\"
+.\" Resetting ref/mod gathering inside of pmap_clear_modify() and
+.\" pmap_clear_reference began with UBC.  Pre-UBC UVM required the
+.\" opposite behavior or it would discover it modified a page trying
+.\" to write it out and get very confused.
+.\"
 .Ss STATISTICS
 The
 .Nm