svn commit: r42201 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup

[Warren Block]

Author: wblock
Date: Tue Jul  9 06:27:56 2013
New Revision: 42201
URL: http://svnweb.freebsd.org/changeset/doc/42201

Log:
  Remove a confusing paragraph whose net contribution is negative.  Remove
  some   from "Ports Collection", it's unnecessary.  Make one example
  section consistent with the actual code.

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

Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml	Tue Jul  9 06:18:31 2013	(r42200)
+++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml	Tue Jul  9 06:27:56 2013	(r42201)
@@ -60,7 +60,7 @@
       should be presented.</para>
 
     <para>The DocBook <acronym>DTD</acronym> is available from the
-      Ports Collection in the
+      Ports Collection in the
       <filename role="package">textproc/docbook-xml-450</filename>
       port.  It is automatically installed as part of the
       <filename role="package">textproc/docproj</filename>
@@ -114,7 +114,7 @@
     </note>
 
     <para>The &os; extensions are not (currently) in the
-      Ports Collection.  They are stored in the &os; Subversion
+      Ports Collection.  They are stored in the &os; Subversion
       tree, as <ulink
 	url="http://svnweb.FreeBSD.org/doc/head/share/xml/freebsd.dtd">head/share/xml/freebsd.dtd</ulink>.</para>
   </sect1>
@@ -1225,9 +1225,6 @@ This is the file called 'foo2'</screen>
 	This makes the generated output, especially
 	<acronym>HTML</acronym>, appear visually better.</para>
 
-      <para>This can be confusing, and sometimes the choice is not
-	always clear.  Hopefully this example makes it clearer.</para>
-
       <example>
 	<title>Applications, Commands, and Options</title>
 
@@ -1320,7 +1317,7 @@ This is the file called 'foo2'</screen>
       </note>
 
       <para>To include the name of a program from the &os;
-	Ports Collection in the document, use the
+	Ports Collection in the document, use the
 	<sgmltag>filename</sgmltag> tag with the
 	<literal>role</literal> attribute set to
 	<literal>package</literal>.  Since ports can be installed in
@@ -2167,8 +2164,8 @@ IMAGES=  chapter1/fig1.png
   <sgmltag class="starttag">link linkend="introduction"</sgmltag>sample introduction<sgmltag class="endtag">link</sgmltag>.<sgmltag class="endtag">para</sgmltag>
 
 <sgmltag class="starttag">para</sgmltag>More specific information can be found in the
-  <sgmltag class="starttag">link linkend="introduction-moredetails"</sgmltag>sample introduction with
-    more details<sgmltag class="endtag">link</sgmltag> section.<sgmltag class="endtag">para</sgmltag></programlisting>
+  <sgmltag class="starttag">link linkend="introduction-moredetails"</sgmltag>sample introduction with more
+    details<sgmltag class="endtag">link</sgmltag> section.<sgmltag class="endtag">para</sgmltag></programlisting>
 
 	  <para>This output will be generated
 	    (<emphasis>emphasized</emphasis> text is used to show the