svn commit: r52103 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer

Sat Aug 11 15:52:27 UTC 2018

Author: sevan
Date: Sat Aug 11 15:52:26 2018
New Revision: 52103
URL: https://svnweb.freebsd.org/changeset/doc/52103

Log:
  Example snippet uses invalid syntax which creates errors when used in a doc.
  Fix spelling mistake while here.
  
  PR:		204893
  Submitted by:	Andreas Perstinger <andipersti at gmail>
  Approved by:	bcr (mentor) rene
  Differential Revision:	https://reviews.freebsd.org/D16680

Modified:
  head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml

Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml
==============================================================================

--- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml	Sat Aug 11 08:33:42 2018	(r52102)
+++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml	Sat Aug 11 15:52:26 2018	(r52103)
@@ -861,7 +861,7 @@ example.xml:5: element head: validity error : Element 
 	  context</link>.</para>
 
       <para>Parameter entity definitions are similar to those for
-	general entities.  However, parameter entries are included
+	general entities.  However, parameter entities are included
 	with
 	<literal>%<replaceable>entity-name</replaceable>;</literal>.
 	The definition also includes the <literal>%</literal> between
@@ -877,13 +877,16 @@ example.xml:5: element head: validity error : Element 
 
 	<programlisting><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" [
-<!ENTITY % param.some "some">
-<!ENTITY % param.text "text">
-<!ENTITY % param.new  "%param.some more %param.text">
-
-<!-- %param.new now contains "some more text" -->
+<!ENTITY % entity "<!ENTITY version '1.0'>">
+<!-- use the parameter entity -->
+%entity;
 ]></programlisting>
       </example>
+
+      <para>At first sight, parameter entities do not look very
+	useful, but they make it possible to <link
+	  linkend="xml-primer-include">include other files</link> into
+	an XML document.</para>
     </sect2>
 
     <sect2 xml:id="xml-primer-to-do">
