r5231 - trunk/editor-manual/chapter01

matthew at linuxfromscratch.org matthew at linuxfromscratch.org
Sun May 8 08:56:30 PDT 2005

Author: matthew
Date: 2005-05-08 09:56:30 -0600 (Sun, 08 May 2005)
New Revision: 5231

Reword explanation of XML book structure, we use XIncludes now, not entities

Modified: trunk/editor-manual/chapter01/changelog.xml
--- trunk/editor-manual/chapter01/changelog.xml	2005-05-08 15:20:27 UTC (rev 5230)
+++ trunk/editor-manual/chapter01/changelog.xml	2005-05-08 15:56:30 UTC (rev 5231)
@@ -29,6 +29,7 @@
  <listitem><para>Changelog Entries:</para>
+   <listitem><para>May 8, 2005 [matt]: Reworded explanation of book XML structure - we use XIncludes now, not entities.</para></listitem>
    <listitem><para>May 8, 2005 [jhuntwork]</para>
      <listitem><para>Removed unnecessary comments about CVS in chapter 3 moving, thanks Randy McMurchy</para></listitem>

Modified: trunk/editor-manual/chapter01/introduction.xml
--- trunk/editor-manual/chapter01/introduction.xml	2005-05-08 15:20:27 UTC (rev 5230)
+++ trunk/editor-manual/chapter01/introduction.xml	2005-05-08 15:56:30 UTC (rev 5231)
@@ -20,13 +20,12 @@
 lists, web hosting, Subversion hosting, the Bugzilla system and
 basically everything we use to work on the LFS project.</para>
-<para>The actual LFS book itself is written using Docbook-XML and at
-first can seem to be a daunting tangle of files. If you're confused, start
-by looking at <filename>index.xml</filename>. At the bottom, you will
-notice that it will reference the entity &book;. Look up the entity
-&book; and you will see that it points to the file
-<filename>book/book.xml</filename>. Continue in this way and you'll find
-your way around the book soon enough.</para>
+<para>The LFS book is written using Docbook-XML and is split into a number of
+XML files.  The directories in the source tree represent the chapters of the
+book, and each XML file within a directory typically contains the text for a
+section within that chapter.  This structure is designed to enable a contributor
+to quickly locate the particular area of the book they are wanting to edit.
 <para>The Bugzilla bug-tracking system for LFS can be found at
 <ulink url="http://bugs.linuxfromscratch.org"/>. In order to be able to

More information about the lfs-book mailing list