From ab2a653990b29334c3a7b19fe63b387e35a886b2 Mon Sep 17 00:00:00 2001
From: Glen Barber <gjb@FreeBSD.org>
Date: Thu, 23 Jul 2015 18:11:52 +0000
Subject: [PATCH] Refine the PAE_TABLES entry based on feedback from kib and
 jhb.

Approved by:	re (implicit)
Sponsored by:	The FreeBSD Foundation
---
 release/doc/en_US.ISO8859-1/relnotes/article.xml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/release/doc/en_US.ISO8859-1/relnotes/article.xml b/release/doc/en_US.ISO8859-1/relnotes/article.xml
index 4a6e577305ef..b86e24c38efe 100644
--- a/release/doc/en_US.ISO8859-1/relnotes/article.xml
+++ b/release/doc/en_US.ISO8859-1/relnotes/article.xml
@@ -803,7 +803,16 @@
       <para revision="281495" contrib="sponsor" sponsor="&ff;">The
 	<literal>PAE_TABLES</literal> kernel configuration option has
 	been added for &os;/&arch.i386;, which instructs &man.pmap.9;
-	to use <acronym>PAE</acronym> format for page tables.</para>
+	to use <acronym>PAE</acronym> format for page tables with
+	32-bit physical addresses.  Unlike the <literal>PAE</literal>
+	option, <literal>PAE_TABLES</literal> preserves kernel binary
+	interface (<acronym>KBI</acronym>) compatibility with
+	non-<literal>PAE</literal> kernels, allowing
+	non-<literal>PAE</literal> kernel modules and drivers to work
+	with a <literal>PAE_TABLES</literal>-enabled kernel.
+	Additionally, system limits are tuned for 4GB maximum
+	<acronym>RAM</acronym>, avoiding kernel virtual address space
+	(<acronym>KVA</acronym>) exhaustion.</para>
 
       <para revision="282215">The <literal>SIFTR</literal> kernel
 	configuration has been added, allowing building &man.siftr.4;