Refine the PAE_TABLES entry based on feedback from kib

and jhb.

Approved by:	re (implicit)
Sponsored by:	The FreeBSD Foundation

1 files changed, 10 insertions, 1 deletions

diff --git a/release/doc/en_US.ISO8859-1/relnotes/article.xml b/release/doc/en_US.ISO8859-1/relnotes/article.xml
index 4b926b2..c2df07f 100644
--- a/release/doc/en_US.ISO8859-1/relnotes/article.xml
+++ b/release/doc/en_US.ISO8859-1/relnotes/article.xml
@@ -353,7 +353,16 @@
       <para revision="282065" 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="282826">The <literal>SIFTR</literal> kernel
 	configuration has been added, allowing building &man.siftr.4;