r5278 - in trunk/editor-manual: chapter01 chapter06

matthew at linuxfromscratch.org matthew at linuxfromscratch.org
Mon May 9 14:11:25 PDT 2005


Author: matthew
Date: 2005-05-09 15:11:22 -0600 (Mon, 09 May 2005)
New Revision: 5278

Modified:
   trunk/editor-manual/chapter01/changelog.xml
   trunk/editor-manual/chapter06/chapter06.xml
   trunk/editor-manual/chapter06/introduction.xml
   trunk/editor-manual/chapter06/updatebook.xml
   trunk/editor-manual/chapter06/updatebugzilla.xml
Log:
Chapter 6 wording improvements

Modified: trunk/editor-manual/chapter01/changelog.xml
===================================================================
--- trunk/editor-manual/chapter01/changelog.xml	2005-05-09 19:31:58 UTC (rev 5277)
+++ trunk/editor-manual/chapter01/changelog.xml	2005-05-09 21:11:22 UTC (rev 5278)
@@ -30,6 +30,9 @@
   <itemizedlist>
    <listitem><para>May 9, 2005 [matthew]</para>
      <itemizedlist>
+       <listitem><para>chapter06: Minor wording improvements and remove mention
+         of FTP updates as this is handled by the FTP maintainers now.</para>
+       </listitem>
        <listitem><para>chapter05/fixbug.xml and chapter05/enternewbugs.xml: Minor wording improvements</para></listitem>
 	 </itemizedlist>
    </listitem>

Modified: trunk/editor-manual/chapter06/chapter06.xml
===================================================================
--- trunk/editor-manual/chapter06/chapter06.xml	2005-05-09 19:31:58 UTC (rev 5277)
+++ trunk/editor-manual/chapter06/chapter06.xml	2005-05-09 21:11:22 UTC (rev 5278)
@@ -12,6 +12,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="introduction.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="updatebugzilla.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="updatebook.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="updateftp.xml"/>
+<!--  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+href="updateftp.xml"/>-->
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="renderchecklinks.xml"/>
 </chapter>

Modified: trunk/editor-manual/chapter06/introduction.xml
===================================================================
--- trunk/editor-manual/chapter06/introduction.xml	2005-05-09 19:31:58 UTC (rev 5277)
+++ trunk/editor-manual/chapter06/introduction.xml	2005-05-09 21:11:22 UTC (rev 5278)
@@ -8,7 +8,7 @@
   <title>Introduction</title>
   <?dbhtml filename="introduction.html"?>
 
-  <para>Updating a package in the LFS-Book consists of three phases:</para>
+  <para>Updating a package in the LFS-Book consists of the following:</para>
 
   <itemizedlist>
 
@@ -16,13 +16,8 @@
       version of a package.</para>
     </listitem>
 
-    <listitem><para>Updating the LFS FTP archive to this new package can be
-      downloaded when it's added to the book. This includes creating a new
-      lfs-packages tarball.</para>
+    <listitem><para>Updating the book to reflect the new version of the package
+      and lfs-packages tarballs.</para>
     </listitem>
-
-    <listitem><para>Updating the book to reflect the new version of package and
-      lfs-packages tarballs.</para>
-    </listitem>
   </itemizedlist>
 </sect1>

Modified: trunk/editor-manual/chapter06/updatebook.xml
===================================================================
--- trunk/editor-manual/chapter06/updatebook.xml	2005-05-09 19:31:58 UTC (rev 5277)
+++ trunk/editor-manual/chapter06/updatebook.xml	2005-05-09 21:11:22 UTC (rev 5278)
@@ -13,8 +13,7 @@
 
   <itemizedlist>
 
-    <listitem><para>Assign yourself to the bug for this new package (you'll find
-      it in Bug #30's Dependency Tree. See previous section).</para>
+    <listitem><para>Assign yourself to the bug for this new package.</para>
     </listitem>
 
     <listitem><para>Download the package to belgarath in your home directory.
@@ -29,23 +28,26 @@
       are used twice, in chapter 5 and in chapter 6.</para>
     </listitem>
 
-    <listitem><para>Update the installation instructions in the book if
+    <listitem><para>Update the installation instructions in the book, if
       necessary.</para>
     </listitem>
 
     <listitem><para>When the package compiles properly and the package works too
       (doesn't seg. fault or show other errors when trying to execute programs
-      from it), then open the <filename>entities/packagename.ent</filename> in
+      from it), then open the <filename>entities/general.ent</filename> in
       an editor.</para>
     </listitem>
 
     <listitem><para>Find the <emphasis>package-version</emphasis> entity and
-      update its value to the new version. Don't change the
-      <emphasis>package-depversion</emphasis> and
-      <emphasis>package-contentversion</emphasis> unless you re-checked the
-      dependencies and contents of the new version.</para>
+      update its value to the new version.</para>
     </listitem>
 
+	<listitem><para>Update the list of files installed by the new version of the
+      package.  This can be trivially gathered by using <command>find</command>
+      immediately prior to and immediately after installing the new version and
+      <command>diff</command>ing the output.</para>
+    </listitem>
+
     <listitem><para>Run <userinput>ls -l package-version.tar.bz2</userinput> on
       the file you have in your home directory on belgarath. Divide the
       filesize by <emphasis>1024</emphasis> to get the number of Kilobytes.
@@ -53,8 +55,6 @@
       <emphasis>package-size</emphasis> entity.</para>
     </listitem>
 
-    <listitem><para>Commit changes to CVS and continue immediately with the next
-      section which will update the LFS FTP archive.</para>
-    </listitem>
+    <listitem><para>Commit your changes to the SVN repository.</para></listitem>
   </itemizedlist>
 </sect1>

Modified: trunk/editor-manual/chapter06/updatebugzilla.xml
===================================================================
--- trunk/editor-manual/chapter06/updatebugzilla.xml	2005-05-09 19:31:58 UTC (rev 5277)
+++ trunk/editor-manual/chapter06/updatebugzilla.xml	2005-05-09 21:11:22 UTC (rev 5278)
@@ -13,19 +13,14 @@
     released, but at least announce it.
   </para>
 
-  <para>We have a special bug for packages updates, Bug #30. All package update
-    bugs are individual bugs, but they are all linked to Bug 30. Bug 30 is the
-    parent bug so to speak.
-  </para>
-
   <itemizedlist>
 
-  <listitem><para>Go to Bug #30's Dependency Tree at <ulink
-    url="http://bugs.linuxfromscratch.org/showdependencytree.cgi?id=30"/></para>  </listitem>
+  <listitem><para>Go to Bugzilla's query page at <ulink
+    url="http://bugs.linuxfromscratch.org/query.cgi"/></para>  </listitem>
 
-  <listitem><para>Find the package that was just updated in this list and click
-    on its link (the link text will be crossed out (ie: a line through it which
-    means it's currently a fixed bug).</para>
+  <listitem><para>Type the name of the package into the summary field and choose
+    all of the statuses to ensure that the package version tracking bug will be
+    found.</para>
   </listitem>
 
   <listitem><para>Update the <emphasis>Summary</emphasis> field to reflect the




More information about the lfs-book mailing list