editor-manual/chapter06/updatebook.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
   3   <!ENTITY % general-entities SYSTEM "../general.ent">
   4   %general-entities;
   5 ]>
   6
   7 <sect1 id="ch06-updatebook">
   8   <title>Update the book</title>
   9   <?dbhtml filename="updatebook.html"?>
  10
  11   <para>When you're going to update the book by adding a new package to it,
  12     here's how you do it:</para>
  13
  14   <itemizedlist>
  15
  16     <listitem><para>Assign yourself to the ticket for this new package.</para>
  17     </listitem>
  18
  19     <listitem><para>Test build an LFS system to make sure this package compiles
  20       properly in an LFS environment. Don't use your regular workstation's
  21       environment - it may be sufficiently different for the compilation to
  22       abort.  A package may depend on something that you have installed but
  23       which doesn't come with the LFS-Book. Also keep in mind that some packages
  24       are used twice, in chapter 5 and in chapter 6.</para>
  25     </listitem>
  26
  27     <listitem><para>Update the installation instructions in the book, if
  28       necessary.</para>
  29     </listitem>
  30
  31     <listitem><para>When the package compiles properly and the package works too
  32       (doesn't seg. fault or show other errors when trying to execute programs
  33       from it), then open the <filename>entities/general.ent</filename> in
  34       an editor.</para>
  35     </listitem>
  36
  37     <listitem><para>Find the <emphasis>package-version</emphasis> entity and
  38       update its value to the new version.</para>
  39     </listitem>
  40
  41         <listitem><para>Update the list of files installed by the new version of the
  42       package.  This can be trivially gathered by using <command>find</command>
  43       immediately prior to and immediately after installing the new version and
  44       <command>diff</command>ing the output.</para>
  45     </listitem>
  46
  47     <listitem><para>We now prefer to use the package's native format (so that md5sums
  48       or signatures can be checked) instead of creating a .tar.bz2 if the package is
  49       supplied only in .tar.gz.  The maintenance of package versions on the LFS mirrors
  50       is handled separately, and there is no longer a need to copy new versions of
  51       packages to your home directory.  Run <userinput>ls -l package-version.tar.{bz2,gz}
  52       </userinput> on the source tarball. Divide the filesize by <emphasis>1024</emphasis>
  53       to get the number of Kilobytes. Round off to the nearest Kilobyte and update the
  54       <emphasis>package-size</emphasis> entity.</para>
  55     </listitem>
  56   </itemizedlist>
  57 </sect1>