documentation-guide/en_US getting-files.xml, 1.6, 1.7 module-struct.xml, 1.6, 1.7 rpm-info.xml, 1.6, 1.7

[Paul W. Frields (pfrields)]

Author: pfrields

Update of /cvs/docs/documentation-guide/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv19758/en_US

Modified Files:
	getting-files.xml module-struct.xml rpm-info.xml 
Log Message:
Additional upgrades and changes; this will go to publication ASAP.


Index: getting-files.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/getting-files.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- getting-files.xml	29 Jun 2007 01:31:29 -0000	1.6
+++ getting-files.xml	1 Jul 2007 18:20:12 -0000	1.7
@@ -88,14 +88,14 @@
       documents for &DISTRO; users around the world.  The flexibility of
       XML allows for a single document to be used many times for many
       purposes, like reusable code for a programmer.</para>
-    <para>DocBook is iself very well documented.  For more information
+    <para>DocBook is itself very well documented.  For more information
       about DocBook, visit <ulink url="http://www.docbook.org/"/>.  The
-      DocBook site also features complete browseable and downloadable
-      copies of <citetitle>DocBook: The Definitive Guide</citetitle>,
-      the canonical source for DocBook information.</para>
+      DocBook site also features complete copies of <citetitle>DocBook:
+	The Definitive Guide</citetitle> to browse and download, the
+      canonical source for DocBook information.</para>
     <note>
       <title>DocBook XML Versions</title>
-      <para>DocBook XML, like a computer progam, has version numbers.
+      <para>DocBook XML, like a computer program, has version numbers.
 	The version used by &FDP; right now is &DBVER;.  The DocBook web
 	site may document a slightly newer version, but the majority of
 	the schema still applies.</para>
@@ -149,10 +149,17 @@
 	linkend="ch-cvs"/>.</para>
     <para>Note in the listing above that the
       <systemitem>about-fedora</systemitem> module has two branches
-      avalable.  One branch is for &DISTRO; 7 and one is for forward
+      available.  One branch is for &DISTRO; 7 and one is for forward
       development to match the current work of developers.  On the other
       hand, the <systemitem>documentation-guide</systemitem> module is
       not branched.</para>
+    <tip>
+      <title>Modules Labeled <filename>-dir</filename></title>
+      <para>Modules ending with the suffix <filename>-dir</filename> are
+	not usually helpful to checkout directly.  These modules do not
+	include the common build tools and thus do not provide many of
+	the functions contributors require.</para>
+    </tip>
     <section id="ch-getting-files-naming-modules">
       <title>Module Names</title>
       <para>Choose a module name that accurately reflects your


Index: module-struct.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/module-struct.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- module-struct.xml	29 Jun 2007 00:10:59 -0000	1.6
+++ module-struct.xml	1 Jul 2007 18:20:12 -0000	1.7
@@ -291,6 +291,11 @@
 	  well.</seg>
       </seglistitem>
     </segmentedlist>
+    <note>
+      <title>PDF Generation is Erratic</title>
+      <para><abbrev>PDF</abbrev> production is currently erratic and may
+	not work for your document.</para>
+    </note>
     <section>
       <title>Adding or Changing Targets</title>
       <para>


Index: rpm-info.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/rpm-info.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- rpm-info.xml	29 Jun 2007 00:10:59 -0000	1.6
+++ rpm-info.xml	1 Jul 2007 18:20:12 -0000	1.7
@@ -33,7 +33,7 @@
   <title>Fedora Documentation Guide</title>
   <desc>Guidelines and procedures for producing documentation for Fedora</desc>
   <changelog order="newest-first">
-    <revision date="2007-06-28" number="0.3.0.1">
+    <revision date="2007-07-01" number="0.3.0.1">
       <author worker="PaulWFrields"/>
       <details>Assorted fixes to reflect newer version of reality</details>
     </revision>