cvs commit: LFS/BOOK/chapter09 whatnow.xml

alex at linuxfromscratch.org alex at linuxfromscratch.org
Sun Mar 14 13:53:12 PST 2004


alex        04/03/14 14:53:12

  Modified:    BOOK     index.xml
               BOOK/chapter01 askforhelp.xml changelog.xml
               BOOK/chapter05 patch.xml
               BOOK/chapter06 chapter06.xml patch.xml
               BOOK/chapter09 whatnow.xml
  Removed:     BOOK/chapter02 askforhelp.xml
  Log:
  Re-adding HOME to the chroot command, and a few textual shuffles.
  
  Revision  Changes    Path
  1.697     +2 -2      LFS/BOOK/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/index.xml,v
  retrieving revision 1.696
  retrieving revision 1.697
  diff -u -r1.696 -r1.697
  --- index.xml	5 Mar 2004 19:06:12 -0000	1.696
  +++ index.xml	14 Mar 2004 21:53:12 -0000	1.697
  @@ -2,8 +2,8 @@
   <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
   			"/usr/share/docbook/docbookx.dtd" [
   
  -<!ENTITY version "CVS-2004-03-05">
  -<!ENTITY releasedate "March 5th, 2004">
  +<!ENTITY version "CVS-2004-03-14">
  +<!ENTITY releasedate "March 14th, 2004">
   <!ENTITY milestone "5.2">
   <!ENTITY nbsp " ">
   
  
  
  
  1.2       +11 -7     LFS/BOOK/chapter01/askforhelp.xml
  
  Index: askforhelp.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/chapter01/askforhelp.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- askforhelp.xml	7 Mar 2004 12:09:30 -0000	1.1
  +++ askforhelp.xml	14 Mar 2004 21:53:12 -0000	1.2
  @@ -1,13 +1,17 @@
   <sect1 id="prepare-askforhelp">
   <title>How to ask for help</title>
  -<?dbhtml filename="askforhelp.html" dir="chapter02"?>
  +<?dbhtml filename="askforhelp.html" dir="chapter01"?>
   
  -<para>If you encounter a problem while using this book, and your problem
  -is not listed in the FAQ (<ulink url="&faq-root;"/>), you will find that
  -most of the people on Internet Relay Chat (IRC) and on the mailing lists
  -are willing to help you (see <xref linkend="ch-scatter-administrativa"/>.
  -To assist us in diagnosing and solving your problem, include as much relevant
  -information as possible in your request for help.</para>
  +<para>If you run into a problem while working through this book, you should
  +first check the FAQ at <ulink url="&faq-root;"/> -- most likely your question
  +is already answered there. If it is not, you should try to find the source of
  +the problem. The following hint might give you some ideas for your
  +troubleshooting: <ulink url="&hints-root;errors.txt"/>.</para>
  +
  +<para>If all that fails, you will find that most people on IRC and the mailing
  +lists (see <xref linkend="ch-scatter-administrativa"/>) are willing to help
  +you. But to assist them in diagnosing and solving your problem, please include
  +all relevant information in your request for help.</para>
   
   <sect2>
   <title>Things to mention</title>
  
  
  
  1.738     +2 -2      LFS/BOOK/chapter01/changelog.xml
  
  Index: changelog.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/chapter01/changelog.xml,v
  retrieving revision 1.737
  retrieving revision 1.738
  diff -u -r1.737 -r1.738
  --- changelog.xml	9 Mar 2004 19:08:32 -0000	1.737
  +++ changelog.xml	14 Mar 2004 21:53:12 -0000	1.738
  @@ -36,8 +36,8 @@
   </itemizedlist>
   </listitem>
   
  -<listitem><para>March 9th, 2004 [alex]: Chapter 6 - Removed HOME and --login
  -from the chroot commands.</para></listitem>
  +<listitem><para>March 9th, 2004 [alex]: Chapter 6 - Removed --login from the
  +chroot commands.</para></listitem>
   
   <listitem><para>March 6th, 2004 [alex]: Rotated the contents of chapters 2, 3
   and 4.</para></listitem>
  
  
  
  1.22      +1 -1      LFS/BOOK/chapter05/patch.xml
  
  Index: patch.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/chapter05/patch.xml,v
  retrieving revision 1.21
  retrieving revision 1.22
  diff -u -r1.21 -r1.22
  --- patch.xml	11 Feb 2004 22:02:10 -0000	1.21
  +++ patch.xml	14 Mar 2004 21:53:12 -0000	1.22
  @@ -13,7 +13,7 @@
   <sect2>
   <title>Installation of Patch</title>
   
  -<para>Prepare Patch for compilation (the preprocessor flag
  +<para>Prepare Patch for compilation (setting the preprocessor flags to
   <emphasis>-D_GNU_SOURCE</emphasis> is only needed on the PowerPC platform, on
   other architectures you can leave it out):</para>
   
  
  
  
  1.78      +17 -12    LFS/BOOK/chapter06/chapter06.xml
  
  Index: chapter06.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/chapter06/chapter06.xml,v
  retrieving revision 1.77
  retrieving revision 1.78
  diff -u -r1.77 -r1.78
  --- chapter06.xml	9 Mar 2004 19:08:33 -0000	1.77
  +++ chapter06.xml	14 Mar 2004 21:53:12 -0000	1.78
  @@ -129,18 +129,21 @@
   populated with only the temporary tools:</para>
   
   <screen><userinput>chroot $LFS /tools/bin/env -i \
  -    TERM=$TERM  PS1='\u:\w\$ ' \
  +    HOME=/root  TERM=$TERM  PS1='\u:\w\$ ' \
       PATH=/bin:/usr/bin:/sbin:/usr/sbin:/tools/bin \
       /tools/bin/bash +h</userinput></screen>
   
  -<para>The <emphasis>-i</emphasis> option given to the
  -<command>env</command> command will clear all variables of the chroot
  -environment. After that, only the TERM, PS1 and PATH variables are
  -set again. The TERM=$TERM construct will set the TERM variable inside chroot
  -to the same value as outside chroot; this variable is needed for programs
  -like <command>less</command> and <command>vim</command> to operate
  -properly. If you need other variables present, such as CFLAGS, CXXFLAGS or
  -HOME, this is a good place to set them.</para>
  +<para>The <emphasis>-i</emphasis> option passed to the <command>env</command>
  +command will clear all variables of the chroot environment. After that, only
  +the HOME, TERM, PS1 and PATH variables are set again. The HOME variable is set
  +mainly to prevent several small warnings during the configure runs of
  +Diffutils, Grep and Grub. The TERM variable is set to make programs such as
  +<command>less</command> and <command>vim</command>, that make use of the
  +Ncurses package, operate properly -- the TERM=$TERM construct sets the TERM
  +variable inside chroot to the same value as outside chroot. The main prompt
  +(PS1) is set to "username:working-dir# " (since the "\$" becomes "#" for root).
  +If you need other variables present, such as CFLAGS, CXXFLAGS or LDFLAGS, this
  +is a good place to set them.</para>
   
   <para>From this point on there's no need to use the LFS variable anymore,
   because everything you do will be restricted to the LFS file system -- since
  @@ -402,7 +405,9 @@
   symbolic link which takes precedence in the Makefile and thus can cause a
   problem here. The above command takes care of this also.</para>
   
  -<para>You can now remove the Binutils source and build directories.</para>
  +<para>You must now remove the Binutils source and build directories. (This is
  +important, as you should start the next section with a fresh untarring of the
  +package.)</para>
   
   <para>The next thing to do is to amend our GCC specs file so that it points
   to the new dynamic linker. Just like earlier on, we use a sed to accomplish
  @@ -580,7 +585,7 @@
   <para>Then reenter it with:</para>
   
   <screen><userinput>chroot $LFS /tools/bin/env -i \
  -    TERM=$TERM  PS1='\u:\w\$ ' \
  +    HOME=/root  TERM=$TERM  PS1='\u:\w\$ ' \
       PATH=/bin:/usr/bin:/sbin:/usr/sbin \
       /tools/bin/bash</userinput></screen>
   
  @@ -610,7 +615,7 @@
   it, you should use the following modified chroot command:</para>
   
   <screen><userinput>chroot $LFS /usr/bin/env -i \
  -    TERM=$TERM  PS1='\u:\w\$ ' \
  +    HOME=/root  TERM=$TERM  PS1='\u:\w\$ ' \
       PATH=/bin:/usr/bin:/sbin:/usr/sbin \
       /bin/bash</userinput></screen>
   
  
  
  
  1.18      +1 -1      LFS/BOOK/chapter06/patch.xml
  
  Index: patch.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/chapter06/patch.xml,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- patch.xml	14 Feb 2004 14:53:12 -0000	1.17
  +++ patch.xml	14 Mar 2004 21:53:12 -0000	1.18
  @@ -15,7 +15,7 @@
   <sect2>
   <title>Installation of Patch</title>
   
  -<para>Prepare Patch for compilation (the preprocessor flag
  +<para>Prepare Patch for compilation (setting the preprocessor flags to
   <emphasis>-D_GNU_SOURCE</emphasis> is only needed on PowerPCs, on other
   machines you can leave it out):</para>
   
  
  
  
  1.5       +18 -13    LFS/BOOK/chapter09/whatnow.xml
  
  Index: whatnow.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/chapter09/whatnow.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- whatnow.xml	27 Jan 2004 22:29:49 -0000	1.4
  +++ whatnow.xml	14 Mar 2004 21:53:12 -0000	1.5
  @@ -2,37 +2,42 @@
   <title>What now?</title>
   <?dbhtml filename="whatnow.html" dir="chapter09"?>
   
  -<para>We thank you for reading the LFS Book and hope that you've found this
  -book useful and worth your time.</para>
  +<para>Thank you for reading the LFS Book. We hope that you've found this book
  +useful and worth your time.</para>
   
   <para>Now that you have finished installing your LFS system, you may be
  -wondering "What now?". In order to answer that question, we have composed a
  -list of resources for you.</para>
  +wondering what to do next. As an answer to that question we have composed a
  +short list of resources:</para>
   
   <itemizedlist>
   <listitem><para>Beyond Linux From Scratch</para>
   
  -<para>The Beyond Linux From Scratch book covers installation procedures
  -for a wide range of software beyond the scope of the LFS Book. The BLFS
  -project can be found at <ulink url="&blfs-root;"/>.</para></listitem>
  +<para>If you want extra utilities for your LFS system, there is the Beyond
  +Linux From Scratch book for you. It covers the installation procedures of many
  +different packages beyond the scope of the LFS book. Among them are
  +general libraries, programming languages, graphical desktops, multimedia,
  +networking and printing. The BLFS project can be found at
  +<ulink url="&blfs-root;"/>.</para></listitem>
   
   <listitem><para>LFS Hints</para>
   
  -<para>The LFS Hints are a collection of small, educational documents
  -submitted by volunteers in the LFS community. The Hints are available at
  -<ulink url="&hints-index;"/>.</para></listitem>
  +<para>The LFS Hints are a collection of educational documents, often small,
  +submitted by volunteers in the LFS community. They cover subjects ranging from
  +dependencies to UTF-8 locales, from optimization to uGlibc, and from cloning to
  +TZ. The Hints are available at <ulink url="&hints-index;"/>.</para></listitem>
   
   <listitem><para>Mailing lists</para>
   
  -<para>There are several LFS mailing lists you may subscribe to if you are
  -in need of help. See <xref linkend="ch-scatter-maillists"/> for more
  +<para>There are several LFS mailing lists you may subscribe to if you want to
  +help develop the book further, assist others to build their systems, or are in
  +need of help yourself. See <ulink url="&lfs-root;mail.html"/> for more
   information.</para></listitem>
   
   <listitem><para>The Linux Documentation Project</para>
   
   <para>The goal of the Linux Documentation Project is to collaborate in
   all of the issues of Linux documentation. The LDP features a large collection
  -of HOWTOs, Guides and man pages; it may be found at
  +of HOWTOs, Guides and man pages, and can be found at
   <ulink url="&tldp-root;"/>.</para></listitem>
   
   </itemizedlist>
  
  
  



More information about the lfs-book mailing list