edit kde, prune TOC

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@849 af4574ff-66df-0310-9fd7-8a98e5e911e0

24 files changed, 82 insertions, 45 deletions

diff --git a/appendices/appendices.xml b/appendices/appendices.xml
index b09f565865..bbba12d7ed 100644
--- a/appendices/appendices.xml
+++ b/appendices/appendices.xml
@@ -2,6 +2,6 @@
 <title>Appendices</title>
 
 &appendices-symlinks;
-&appendices-old;
+<!-- &appendices-old;-->
 
 </part>
diff --git a/connect/other/other.xml b/connect/other/other.xml
index 3ac63f9c1e..056840e616 100644
--- a/connect/other/other.xml
+++ b/connect/other/other.xml
@@ -2,7 +2,9 @@
 <?dbhtml filename="other.html" dir="connect"?>
 <title>Other</title>
 
-&connect-other-isdn;
-&connect-other-pppoe;
+<para>Other methods to connect to large networks are through ISDN and
+PPPOE interfaces. Pages written for these interfaces are always welcome
+and will be included in future books, if available.</para>
+
 
 </chapter>
diff --git a/content/web/web.xml b/content/web/web.xml
index 9f93f49ffb..8cba6951c8 100644
--- a/content/web/web.xml
+++ b/content/web/web.xml
@@ -3,6 +3,6 @@
 <title>Web serving</title>
 
 &apache;
-&php;
+<!-- &php -->
 
 </chapter>
diff --git a/gnome/add/gst-plugins.xml b/gnome/add/gst-plugins.xml
index 1e026949d5..c2fdd52282 100644
--- a/gnome/add/gst-plugins.xml
+++ b/gnome/add/gst-plugins.xml
@@ -4,7 +4,6 @@
 
 &gst-plugins-intro;
 &gst-plugins-inst;
-&gst-plugins-desc;
 
 </sect1>
 
diff --git a/gnome/add/media/gst-plugins-intro.xml b/gnome/add/media/gst-plugins-intro.xml
index 132dd039ac..be11c6c03f 100644
--- a/gnome/add/media/gst-plugins-intro.xml
+++ b/gnome/add/media/gst-plugins-intro.xml
@@ -10,8 +10,6 @@ Estimated Disk space required:  &gst-plugins-buildsize;</screen>
 <para>The gst-plugins package contains codec interfaces.</para>
 
 <screen>gst-plugins depends on:
-<xref linkend="gstreamer"/>
-gst-plugins will utilize:
-[still compiling]</screen>
+<xref linkend="gstreamer"/></screen>
 
 </sect2>
diff --git a/gnome/add/media/gst-plugins.ent b/gnome/add/media/gst-plugins.ent
index b6fea19a42..77fc25abed 100644
--- a/gnome/add/media/gst-plugins.ent
+++ b/gnome/add/media/gst-plugins.ent
@@ -4,7 +4,7 @@
 <!ENTITY gst-plugins-exp SYSTEM "gst-plugins-exp.xml">
 <!ENTITY gst-plugins-desc SYSTEM "gst-plugins-desc.xml">
 <!ENTITY gst-plugins-config SYSTEM "gst-plugins-config.xml">
-<!ENTITY gst-plugins-buildsize "">
+<!ENTITY gst-plugins-buildsize "98 MB">
 <!ENTITY gst-plugins-version "0.6.0">
 <!ENTITY gst-plugins-download-http "http://ftp.gnome.org/pub/GNOME/sources/gst-plugins/0.6/gst-plugins-0.6.0.tar.bz2">
 <!ENTITY gst-plugins-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/gst-plugins/0.6/gst-plugins-0.6.0.tar.bz2">
diff --git a/index.xml b/index.xml
index 0b4608c26e..92b8ed498a 100644
--- a/index.xml
+++ b/index.xml
@@ -2,8 +2,8 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
 			"/usr/share/docbook/docbookx.dtd" [
 
-<!ENTITY version "20030413">
-<!ENTITY releasedate "April 13th, 2003">
+<!ENTITY version "20030414">
+<!ENTITY releasedate "April 14th, 2003">
 
 <!ENTITY % book SYSTEM "book/book.ent">
 <!ENTITY % preface SYSTEM "preface/preface.ent">
diff --git a/introduction/welcome/askhelp.xml b/introduction/welcome/askhelp.xml
index cc2f87d4cb..cb0afdd121 100644
--- a/introduction/welcome/askhelp.xml
+++ b/introduction/welcome/askhelp.xml
@@ -13,6 +13,36 @@ your problem, include as much relevant information as possible in your
 request for help.</para>
 
 <sect2>
+<title>Things to check prior to asking</title>
+
+<para>Before asking for help, you should review the following
+items:</para>
+
+<itemizedlist>
+<listitem><para>Is the hardware support compiled into the kernel or
+available as a module to the kernel.  If it is a module, is it configured
+properly in <filename>modules.conf</filename> and has it been loaded.  You
+should use <userinput>lsmod</userinput> to see if it's loaded. Check the
+<filename>sys.log</filename> or run <userinput>modprobe
+&lt;driver&gt;</userinput>
+to review any error message.  If it loads properly, you may need to add
+the <userinput>modprobe</userinput> to your boot scripts.</para></listitem>
+
+<listitem><para>Are your permissions properly set, especially for
+devices.  LFS uses groups to make these settings easier, but it also
+adds the step of adding users to groups to allow access. A simple
+<userinput>moduser -G audio &lt;user&gt;</userinput> may be all that's
+necessary for that user to have access to the sound
+system.  Any question that starts out with "It works as root, but not as
+..." should review permissions throughly prior to asking.</para></listitem>
+
+<listitem><para>BLFS liberally uses <filename>/opt/&lt;package&gt;</filename>. The main objection to this centers around the need to
+expand you environment variables for each package placed there (e.g.
+PATH=$PATH:/opt/kde/bin).  In some cases, the package will walk you
+through the changes, but some will not.</para></listitem>
+</itemizedlist></sect2>
+
+<sect2>
 <title>Things to mention</title>
 
 <para>Apart from a brief explanation of the problem you're having, the
@@ -32,6 +62,16 @@ all.</para></listitem>
 <para>(Note that saying that you've deviated from the book doesn't mean
 that we won't help you. It'll just help us to see other possible causes of your problem.)</para>
 
+<para>Expect guidance instead of specific instructions. If you are
+instructed to read something, please do so, it generally implies that
+the answer was way too obvious and that the question would not have been asked if a little
+research was done prior to asking. The volunteers in the mailing list
+prefer not to be used as an alternative to doing reasonable research on
+your end.  In addition, the quality of your experience with BLFS is also greatly
+enhanced by this research, and the quality of volunteers is enhanced
+because they don't feel that their time has been abused, so they are
+far more likely to participate.</para>
+
 <para>An excellent article on asking for help on the Internet in general
 has been written by Eric S. Raymond. It is available online at <ulink
 url="http://www.tuxedo.org/~esr/faqs/smart-questions.html"/>.
diff --git a/introduction/welcome/changelog.xml b/introduction/welcome/changelog.xml
index fde158dec2..4112d0e7a3 100644
--- a/introduction/welcome/changelog.xml
+++ b/introduction/welcome/changelog.xml
@@ -10,6 +10,9 @@ page in Chapter 1 for details on who wrote what.</para>
 
 <itemizedlist>
 
+<listitem><para>April 14th,2003 [larry]: Tree pruning.  All unfinished
+work was commented out.</para></listitem>
+
 <listitem><para>April 12th 2003 [larry]: modified instructions for
 wvstreams and wvdial as submitted by Alexander E.
 Patrakov.</para></listitem>
diff --git a/kde/core/arts.xml b/kde/core/arts.xml
index ac5cfad1c9..327c49ee60 100644
--- a/kde/core/arts.xml
+++ b/kde/core/arts.xml
@@ -32,18 +32,18 @@ you have less than 256MB of RAM, this option may cause swapping and
 significantly slow compilation.</para></note>
 
 <sect2><title>aRts Installation Command explanations</title>
-<para><userinput>--prefix=&kde-dir;:</userinput> This option tells the
+<para><userinput>--prefix=&kde-dir;</userinput> : This option tells the
 process to install the package in &kde-dir;.  We put aRts here because this
 package is required before installing KDE.</para>
 
-<para><userinput>--disable-debug:</userinput> This option causes the
+<para><userinput>--disable-debug</userinput> : This option causes the
 system to be compiled without debugging code.
 </para>
 
-<para><userinput>--disable-dependency-tracking:</userinput> This option speeds
+<para><userinput>--disable-dependency-tracking</userinput> : This option speeds
 up one time builds.</para>
 
-<para><userinput>ln -sfn &kde-dir; /opt/kde:</userinput> This command creates
+<para><userinput>ln -sfn &kde-dir; /opt/kde</userinput> : This command creates
 a link for access to KDE.  If a newer version of KDE is released, the new
 system can be built by changing the <userinput>--prefix</userinput> location
 and then set up by changing the link as this command does.
diff --git a/kde/core/config.xml b/kde/core/config.xml
index ed0a9189e5..965dd28aa0 100644
--- a/kde/core/config.xml
+++ b/kde/core/config.xml
@@ -11,7 +11,7 @@ and ensure all libraries can be found with:
 <screen><userinput>ldconfig</userinput></screen>
 </para>
 
-<para>At this point you can bring up KDE with
-<userinput>startx</userinput></para>
+<para>At this point you can bring up KDE with:
+<screen><userinput>startx</userinput></screen></para>
 
 </sect1>
diff --git a/kde/inst/kde-admin.xml b/kde/inst/kde-admin.xml
index 7740e3d5e8..e2196f00e8 100644
--- a/kde/inst/kde-admin.xml
+++ b/kde/inst/kde-admin.xml
@@ -11,7 +11,7 @@ Estimated build time:        10 min (667 MHz)</screen></para>
 <para>kdeadmin depends on:
 <screen><xref linkend="kde-base"/>.
 The kpackage program can use <filename>rpm</filename>.
-kuser can use <filename>shadow</filename> and <filename>pam</filename>.</screen></para>
+kuser can use <filename>shadow</filename> and <xref linkend="Linux_PAM"/>.</screen></para>
 
 <para>Install kdeadmin with:
 <screen><userinput>./configure --prefix=&kde-dir; --disable-debug \
@@ -22,7 +22,7 @@ make install</userinput></screen></para>
 <sect2>
 <title>kdeadmin Installation Command explanations</title>
 
-<para><userinput>--with-shadow:</userinput> This option allows use of 
+<para><userinput>--with-shadow</userinput> : This option allows use of 
 shadow passwords.</para>
 
 </sect2>
diff --git a/kde/inst/kde-base.xml b/kde/inst/kde-base.xml
index 19b396eaa6..b4c88ee83e 100644
--- a/kde/inst/kde-base.xml
+++ b/kde/inst/kde-base.xml
@@ -9,7 +9,7 @@ Estimated build time:        98 min (667 MHz)</screen></para>
 <para>kdebase can use many optional libraries and programs.  The following are
 recommended:
 <screen><xref linkend="openssl"/>, <xref linkend="lesstif"/>, <xref linkend="CDParanoia"/>, <xref linkend="libvorbis"/>,
-shadow (in the LFS book), and cups.</screen></para>
+shadow (in the LFS book), and <xref linkend="cups"/>.</screen></para>
 
 <para>Other programs and libraries that can be used by kdebase are:
 <screen><xref linkend="lame"/>, and <xref linkend="Linux_PAM"/></screen></para>
@@ -26,11 +26,11 @@ make install</userinput></screen></para>
 <sect2>
 <title>kdebase Installation Command explanations</title>
  
-<para><userinput>--disable-lametest:</userinput> Do not search for and use 
+<para><userinput>--disable-lametest</userinput> : Do not search for and use 
 lame support.  This package provides mp3 encoding. Omit this option if
 you installed <filename>lame</filename>.</para>
   
-<para><userinput>--with-shadow:</userinput> Use shadow password 
+<para><userinput>--with-shadow</userinput> : Use shadow password 
 support.</para>
 </sect2>
 
diff --git a/kde/inst/kde-graphics.xml b/kde/inst/kde-graphics.xml
index 05a2d23344..560ce421a4 100644
--- a/kde/inst/kde-graphics.xml
+++ b/kde/inst/kde-graphics.xml
@@ -11,7 +11,7 @@ Estimated build time:        24 min (667 MHz)</screen></para>
 <para>kdegraphics depends on:
 <screen><xref linkend="kde-base"/> and <xref linkend="which"/> (or the which script).
 The kuickshow program requires <xref linkend="imlib"/>.
-The kooka program requires <filename>sane</filename>.</screen></para>
+The kooka program requires <xref linkend="sane"/>.</screen></para>
 
 <para>Install kdegraphics with:
 <screen><userinput>./configure --prefix=&kde-dir; --disable-debug \
diff --git a/kde/inst/kde-libs.xml b/kde/inst/kde-libs.xml
index 0eefee720e..9e714832d6 100644
--- a/kde/inst/kde-libs.xml
+++ b/kde/inst/kde-libs.xml
@@ -7,11 +7,11 @@ Estimated installed space:   41 MB
 Package size:                &kde-libs-size;
 Estimated build time:        62 min (667 MHz)</screen></para>
 
-
+<!-- 
 <warning><para>The KDE instructions are being revised.  The instructions should
 work as described in the following sections, but not all KDE packages
 have been validated.</para></warning>
-
+-->
 
 
 <para>The following package is required to install kdelibs:
@@ -31,19 +31,19 @@ make &amp;&amp;
 make install</userinput></screen></para>       
 
 <sect2><title>kdelibs Installation Command explanations</title>
-<para><userinput>--prefix=&kde-dir;:</userinput> This option tells
+<para><userinput>--prefix=&kde-dir;</userinput> : This option tells
 the process to install the package in &kde-dir;.</para>
 
-<para><userinput>--disable-debug:</userinput> This option causes the
+<para><userinput>--disable-debug</userinput> : This option causes the
 system to be compiled without debugging code.</para>
 
-<para><userinput>--disable-dependency-tracking:</userinput> This option
+<para><userinput>--disable-dependency-tracking</userinput> : This option
 speeds up one time builds.</para>
 
-<para><userinput>--with-alsa:</userinput> This option tells the build process to
+<para><userinput>--with-alsa</userinput> : This option tells the build process to
 search for and use Alsa for sound support.</para>
 
-<para><userinput>--enable-fast-malloc=full:</userinput> This option tells
+<para><userinput>--enable-fast-malloc=full</userinput> : This option tells
 KDE programs to use an internal memory allocation scheme 
 optimized for KDE.</para>
 </sect2>
diff --git a/kde/inst/kde-multimedia.xml b/kde/inst/kde-multimedia.xml
index 29745c0c81..9437f93df1 100644
--- a/kde/inst/kde-multimedia.xml
+++ b/kde/inst/kde-multimedia.xml
@@ -20,7 +20,7 @@ make install</userinput></screen></para>
 <sect2>
 <title>kdemultimedia Installation Command explanations</title>
 
-<para><userinput>--with-arts-alsa:</userinput> Use the alsa support built 
+<para><userinput>--with-arts-alsa</userinput> : Use the alsa support built 
 into aRts.</para>
 
 </sect2>
diff --git a/kde/kde.ent b/kde/kde.ent
index dd728e9aed..723511e39a 100644
--- a/kde/kde.ent
+++ b/kde/kde.ent
@@ -48,7 +48,7 @@
 <!ENTITY kde-dir "/opt/kde-&kde-version;">
 
 <!ENTITY kde-libs-ftp "&kde-download;/kdelibs-&kde-version;.tar.bz2">
-<!ENTITY kde-libs-size "7.2 MB">
+<!ENTITY kde-libs-size " 7.2 MB">
 <!ENTITY kde-base-ftp "&kde-download;/kdebase-&kde-version;.tar.bz2">
 <!ENTITY kde-base-size "12.0 MB">
 <!ENTITY kde-multimedia-ftp "&kde-download;/kdemultimedia-&kde-version;.tar.bz2">
diff --git a/kde/other/other.xml b/kde/other/other.xml
index 635fc00882..db5d2f6eeb 100644
--- a/kde/other/other.xml
+++ b/kde/other/other.xml
@@ -3,9 +3,6 @@
 <title>Other KDE Packages</title>
 
 &kdoc;
-&kde-bindings;
-&kde-sdk;
 &kdevelop;
-&kdm;
 
 </chapter>
diff --git a/postlfs/config/config.xml b/postlfs/config/config.xml
index d01c0adcc1..013e1216b4 100644
--- a/postlfs/config/config.xml
+++ b/postlfs/config/config.xml
@@ -23,7 +23,7 @@ be vim, emacs or anything else.</para>
 &postlfs-config-random;
 &postlfs-config-vimrc;
 &postlfs-config-bootdisk;
-&postlfs-config-manpages;
+<!--&postlfs-config-manpages;-->
 &postlfs-config-skel;
 
 </chapter>
diff --git a/postlfs/security/security.xml b/postlfs/security/security.xml
index fe8e314b3b..88213c28a6 100644
--- a/postlfs/security/security.xml
+++ b/postlfs/security/security.xml
@@ -7,6 +7,6 @@
 &postlfs-security-fw;
 &tripwire;
 &Linux_PAM;
-&postlfs-security-syslog;
+<!--&postlfs-security-syslog;-->
 
 </chapter>
diff --git a/preface/organization.xml b/preface/organization.xml
index df6374678d..c9dc37cdb4 100644
--- a/preface/organization.xml
+++ b/preface/organization.xml
@@ -32,8 +32,8 @@ bulk of this part.</para></sect2>
 CVS, etc.).</para></sect2>
 
 <sect2><title>Part VII - Content Serving</title>
-<para>In this part we deal with databases and web server software (including
-php).</para></sect2>
+<para>In this part we deal with databases and web server software
+<!--(including php)-->.</para></sect2>
 
 <sect2><title>Part VIII - X + Window Managers</title>
 <para>This part explains how to set up a basic XFree86 installation along
diff --git a/server/mail/mail.xml b/server/mail/mail.xml
index 3b8151c0c9..08dee73433 100644
--- a/server/mail/mail.xml
+++ b/server/mail/mail.xml
@@ -6,14 +6,13 @@
 other.  The traditional MTA is <emphasis>sendmail</emphasis> however
 there are several other choices.</para>
 
-<para>As well as SMTP servers there are two other packages here, a POP
-server (qpopper) and an IMAP server (Courier-IMAP).</para>
+<para>As well as SMTP servers there is a POP server (qpopper). An IMAP
+server (Courier-IMAP) is available for inclusion in the next version.</para>
 
 &postfix;
 &qmail;
 &sendmail;
 &exim;
 &qpopper;
-&courier;
-
+<!--&courier-->
 </chapter>
diff --git a/xsoft/office/office.xml b/xsoft/office/office.xml
index 7c661db1f9..154417f6ee 100644
--- a/xsoft/office/office.xml
+++ b/xsoft/office/office.xml
@@ -5,7 +5,6 @@
 &AbiWord;
 &gnumeric;
 &gnucash;
-&magicpoint;
 &gimp;
 &evolution;
 
diff --git a/xsoft/suites/openoffice/openoffice-intro.xml b/xsoft/suites/openoffice/openoffice-intro.xml
index 623a928b37..ff6f2036fc 100644
--- a/xsoft/suites/openoffice/openoffice-intro.xml
+++ b/xsoft/suites/openoffice/openoffice-intro.xml
@@ -16,7 +16,7 @@ StarOffice.</para>
 <xref linkend="freetype2"/>, <xref linkend="xfree86"/>, <xref linkend="j2sdk"/>,
 <xref linkend="zip"/>, <xref linkend="unzip"/>, <xref linkend="tcsh"/>,
 <xref linkend="db"/>, <xref linkend="STLport"/>, <xref linkend="which"/>
-and mktemp
+and <ulink url="http://www.courtesan.com/mktemp">mktemp</ulink>
 openoffice will utilize:
 ant
 </screen>