editor-manual/chapter06/updatebook.xml

   1 <sect1 id="ch06-updatebook">
   2 <title>Update the book</title>
   3 <?dbhtml filename="updatebook.html" dir="chapter06"?>
   4
   5 <para>When you're going to update the book by adding a new package to it,
   6 here's how you do it:</para>
   7
   8 <itemizedlist>
   9
  10 <listitem><para>Assign yourself to the bug for this new package (you'll
  11 find it in Bug #30's Dependency Tree. See previous
  12 section).</para></listitem>
  13
  14 <listitem><para>Download the package to shadowfax in your home directory.
  15 If it's not bzip2'ed, then make it so.</para></listitem>
  16
  17 <listitem><para>Test build an LFS system to make sure this package compiles
  18 properly in an LFS environment. Don't use your regular workstation's
  19 environment - it may be sufficiently different for the compilation to
  20 abort. A package may depend on something that you have installed but which
  21 doesn't come with the LFS-Book. Also keep in mind that some packages are
  22 used twice, in chapter 5 and in chapter 6.</para></listitem>
  23
  24 <listitem><para>Update the installation instructions in the book if
  25 necessary.</para></listitem>
  26
  27 <listitem><para>When the package compiles properly and the package works
  28 too (doesn't seg. fault or show other errors when trying to execute programs
  29 from it), then open the <filename>entities/packagename.ent</filename> in an
  30 editor.</para></listitem>
  31
  32 <listitem><para>Find the <emphasis>package-version</emphasis> entity and
  33 update its value to the new version. Don't change the
  34 <emphasis>package-depversion</emphasis> and
  35 <emphasis>package-contentversion</emphasis> unless you re-checked the
  36 dependencies and contents of the new version.</para></listitem>
  37
  38
  39 <listitem><para>Run <userinput>ls -l package-version.tar.bz2</userinput> on
  40 the file you have in your home directory on shadowfax. Divide the filesize
  41 by <emphasis>1024</emphasis> to get the number of Kilobytes. Round off to
  42 the nearest Kilobyte and update the <emphasis>package-size</emphasis>
  43 entity.</para></listitem>
  44
  45 <listitem><para>Commit changes to CVS and continue immediately with the
  46 next section which will update the LFS FTP archive.</para></listitem>
  47
  48 </itemizedlist>
  49
  50 </sect1>
  51