From 6d1ec6fad367f8fc3a38837b9bfbfdf00589cecb Mon Sep 17 00:00:00 2001
From: Hiten Pandya <hmp@dragonflybsd.org>
Date: Fri, 21 May 2004 11:03:14 +0000
Subject: [PATCH] Document the pmap_kenter_quick(9) function.  While I am here,
 fix comment style for pmap_kenter(9).

---
 sys/i386/i386/pmap.c          | 16 ++++++++++++----
 sys/platform/pc32/i386/pmap.c | 16 ++++++++++++----
 2 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/sys/i386/i386/pmap.c b/sys/i386/i386/pmap.c
index 8db1a05690..39ec75aa03 100644
--- a/sys/i386/i386/pmap.c
+++ b/sys/i386/i386/pmap.c
@@ -40,7 +40,7 @@
  *
  *	from:	@(#)pmap.c	7.7 (Berkeley)	5/12/91
  * $FreeBSD: src/sys/i386/i386/pmap.c,v 1.250.2.18 2002/03/06 22:48:53 silby Exp $
- * $DragonFly: src/sys/i386/i386/Attic/pmap.c,v 1.39 2004/05/13 17:40:14 dillon Exp $
+ * $DragonFly: src/sys/i386/i386/Attic/pmap.c,v 1.40 2004/05/21 11:03:14 hmp Exp $
  */
 
 /*
@@ -685,9 +685,11 @@ pmap_extract_vmpage(pmap_t pmap, vm_offset_t va, int prot)
  ***************************************************/
 
 /*
- * add a wired page to the kva
- * note that in order for the mapping to take effect -- you
- * should do a invltlb after doing the pmap_kenter...
+ * Routine: pmap_kenter
+ * Function:
+ *  	Add a wired page to the KVA
+ *  	NOTE! note that in order for the mapping to take effect -- you
+ *  	should do an invltlb after doing the pmap_kenter().
  */
 void 
 pmap_kenter(vm_offset_t va, vm_paddr_t pa)
@@ -704,6 +706,12 @@ pmap_kenter(vm_offset_t va, vm_paddr_t pa)
 	pmap_inval_flush(&info);
 }
 
+/*
+ * Routine: pmap_kenter_quick
+ * Function:
+ *  	Similar to pmap_kenter(), except we only invalidate the
+ *  	mapping on the current CPU.
+ */
 void
 pmap_kenter_quick(vm_offset_t va, vm_paddr_t pa)
 {
diff --git a/sys/platform/pc32/i386/pmap.c b/sys/platform/pc32/i386/pmap.c
index cc53a0ec2f..4322b83a57 100644
--- a/sys/platform/pc32/i386/pmap.c
+++ b/sys/platform/pc32/i386/pmap.c
@@ -40,7 +40,7 @@
  *
  *	from:	@(#)pmap.c	7.7 (Berkeley)	5/12/91
  * $FreeBSD: src/sys/i386/i386/pmap.c,v 1.250.2.18 2002/03/06 22:48:53 silby Exp $
- * $DragonFly: src/sys/platform/pc32/i386/pmap.c,v 1.39 2004/05/13 17:40:14 dillon Exp $
+ * $DragonFly: src/sys/platform/pc32/i386/pmap.c,v 1.40 2004/05/21 11:03:14 hmp Exp $
  */
 
 /*
@@ -685,9 +685,11 @@ pmap_extract_vmpage(pmap_t pmap, vm_offset_t va, int prot)
  ***************************************************/
 
 /*
- * add a wired page to the kva
- * note that in order for the mapping to take effect -- you
- * should do a invltlb after doing the pmap_kenter...
+ * Routine: pmap_kenter
+ * Function:
+ *  	Add a wired page to the KVA
+ *  	NOTE! note that in order for the mapping to take effect -- you
+ *  	should do an invltlb after doing the pmap_kenter().
  */
 void 
 pmap_kenter(vm_offset_t va, vm_paddr_t pa)
@@ -704,6 +706,12 @@ pmap_kenter(vm_offset_t va, vm_paddr_t pa)
 	pmap_inval_flush(&info);
 }
 
+/*
+ * Routine: pmap_kenter_quick
+ * Function:
+ *  	Similar to pmap_kenter(), except we only invalidate the
+ *  	mapping on the current CPU.
+ */
 void
 pmap_kenter_quick(vm_offset_t va, vm_paddr_t pa)
 {
-- 
2.41.0