diff --git a/en_US.ISO8859-1/books/ppp-primer/book.sgml b/en_US.ISO8859-1/books/ppp-primer/book.sgml
index 92a3f68233..76f9fb19c1 100644
--- a/en_US.ISO8859-1/books/ppp-primer/book.sgml
+++ b/en_US.ISO8859-1/books/ppp-primer/book.sgml
@@ -1,4 +1,8 @@
-<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN">
+<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN" [
+<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
+%man;
+]>
+
 <book>
 
 <bookinfo>
@@ -14,7 +18,7 @@
 </author>
 </authorgroup>
 
-<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/ppp-primer/book.sgml,v 1.5 2000/11/16 14:21:50 ben Exp $</pubdate>
+<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/ppp-primer/book.sgml,v 1.6 2001/01/17 07:22:10 brian Exp $</pubdate>
 
 <abstract><para>This is a step-by-step guide for configuring FreeBSD systems to act as
 a dial-up router/gateway in a Local Area Environment.  All entries may
@@ -772,6 +776,16 @@ dial-out connection working.</para>
   
 <para>Below is the /etc/ppp/ppp.conf file that we'll be using to provide a
 dial-out Internet gateway for our example LAN:
+
+<note>
+  <para>The full syntax for <filename>ppp.conf</filename> is described in
+    &man.ppp.8;.  Particuarly, note that any line that isn't a label that
+    ends with a colon (e.g., <literal>default:</literal>,
+    <literal>interactive:</literal>), a command that begins with
+    <quote>!</quote> (e.g., <literal>!include</literal>), or a comment
+    <emphasis>must</emphasis> be indented!</para>
+</note>
+
 <programlisting>
 ################################################################
 # PPP Configuration File ('/etc/ppp/ppp.conf')
diff --git a/en_US.ISO_8859-1/books/ppp-primer/book.sgml b/en_US.ISO_8859-1/books/ppp-primer/book.sgml
index 92a3f68233..76f9fb19c1 100644
--- a/en_US.ISO_8859-1/books/ppp-primer/book.sgml
+++ b/en_US.ISO_8859-1/books/ppp-primer/book.sgml
@@ -1,4 +1,8 @@
-<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN">
+<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN" [
+<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
+%man;
+]>
+
 <book>
 
 <bookinfo>
@@ -14,7 +18,7 @@
 </author>
 </authorgroup>
 
-<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/ppp-primer/book.sgml,v 1.5 2000/11/16 14:21:50 ben Exp $</pubdate>
+<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/ppp-primer/book.sgml,v 1.6 2001/01/17 07:22:10 brian Exp $</pubdate>
 
 <abstract><para>This is a step-by-step guide for configuring FreeBSD systems to act as
 a dial-up router/gateway in a Local Area Environment.  All entries may
@@ -772,6 +776,16 @@ dial-out connection working.</para>
   
 <para>Below is the /etc/ppp/ppp.conf file that we'll be using to provide a
 dial-out Internet gateway for our example LAN:
+
+<note>
+  <para>The full syntax for <filename>ppp.conf</filename> is described in
+    &man.ppp.8;.  Particuarly, note that any line that isn't a label that
+    ends with a colon (e.g., <literal>default:</literal>,
+    <literal>interactive:</literal>), a command that begins with
+    <quote>!</quote> (e.g., <literal>!include</literal>), or a comment
+    <emphasis>must</emphasis> be indented!</para>
+</note>
+
 <programlisting>
 ################################################################
 # PPP Configuration File ('/etc/ppp/ppp.conf')