Rewrote diffutils + fileutils installation pages, added previously not 'cvs add'ed files

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2310 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Gerard Beekmans 2003-01-11 17:06:14 +00:00
parent 873ec17716
commit 2b138d6d32
17 changed files with 107 additions and 50 deletions

View File

@ -0,0 +1,19 @@
<sect2><title>Contents of Bzip2</title>
<para>Last checked against version &bzip2-contversion;</para>
<para>Bzip2 is a block-sorting file compressor which generally achieves a
better compression than the traditional <userinput>gzip</userinput>
does.</para>
<para>Bzip2 installs the following files:</para>
<sect3><title>Program Files</title>
<para>bunzip2 (link to bzip2), bzcat (link to bzip2), bzcmp, bzdiff, bzegrep,
bzfgrep, bzgrep, bzip2, bzip2recover, bzless and bzmore</para></sect3>
<sect3><title>Library Files</title>
<para>libbz2.a, libbz2.so (link to libbz2.so.1.0), libbz2.so.1.0 (link to
libbz2.so.1.0.2) and libbz2.so.1.0.2</para></sect3>
</sect2>

View File

@ -1,3 +1,5 @@
<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
<sect2>
<title>Diffutils Installation Dependencies</title>

View File

@ -1,11 +1,10 @@
<sect2><title>Contents of Diffutils</title>
<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
<sect2><title>Descriptions</title>
<para>Last checked against version &diffutils-contversion;.</para>
<sect3><title>Program Files</title>
<para>cmp, diff, diff3 and sdiff</para></sect3>
<sect3><title>Descriptions</title>
<sect3><title>Program files descriptions</title>
<sect4><title>cmp and diff</title>
<para>cmp and diff both compare two files and report their differences. Both

View File

@ -0,0 +1,15 @@
<sect2><title>Contents of Diffutils</title>
<para>Last checked against version &diffutils-contversion;.</para>
<para>The programs from this package show you the differences between two
files or directories. It's most common use is to create software
patches.</para>
<para>Diffutils installs the following files:</para>
<sect3><title>Program Files</title>
<para>cmp, diff, diff3 and sdiff</para></sect3>
</sect2>

View File

@ -3,6 +3,7 @@
<?dbhtml filename="diffutils.html" dir="appendixa"?>
&aa-diffutils-down;
&aa-diffutils-shortdesc;
&aa-diffutils-desc;
&aa-diffutils-dep;

View File

@ -1,3 +1,5 @@
<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
<sect2>
<title>Fileutils Installation Dependencies</title>

View File

@ -1,13 +1,10 @@
<sect2><title>Contents of Fileutils</title>
<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
<sect2><title>Descriptions</title>
<para>Last checked against version &fileutils-contversion;.</para>
<sect3><title>Program Files</title>
<para>chgrp, chmod, chown, cp, dd, df, dir, dircolors, du, install, ln,
ls, mkdir, mkfifo, mknod, mv, rm, rmdir, shred, sync, touch
and vdir</para></sect3>
<sect3><title>Descriptions</title>
<sect3><title>Program files descriptions</title>
<sect4><title>chgrp</title>
<para>chgrp changes the group ownership of each given file to the named group,

View File

@ -0,0 +1,17 @@
<sect2><title>Contents of Fileutils</title>
<para>Last checked against version &fileutils-contversion;.</para>
<para>Fileutils is a package containing basic file manipulation programs.
Including are programs to list directories, create directories, update
timestamps, change permissions and so forth.</para>
<para>Fileutils installs the following files:</para>
<sect3><title>Program Files</title>
<para>chgrp, chmod, chown, cp, dd, df, dir, dircolors, du, install, ln,
ls, mkdir, mkfifo, mknod, mv, rm, rmdir, shred, sync, touch
and vdir</para></sect3>
</sect2>

View File

@ -3,6 +3,7 @@
<?dbhtml filename="fileutils.html" dir="appendixa"?>
&aa-fileutils-down;
&aa-fileutils-shortdesc;
&aa-fileutils-desc;
&aa-fileutils-dep;

View File

@ -1,13 +0,0 @@
<sect2>
<title>Command explanations</title>
<para><userinput>CPPFLAGS=-Dre_max_failures=re_max_failures2:</userinput> The
CPPFLAGS variable is a variable that's read by the cpp program (C
PreProcessor). The value of this variable tells the preprocessor to
replace every instance of re_max_failures it finds by re_max_failures2
before handing the source file to the compiler itself for compilation. This
package has problems linking statically on systems that run an older
Glibc version and this construction fixes that problem.</para>
</sect2>

View File

@ -1,11 +1,37 @@
<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
<sect2>
<title>Installation of Diffutils</title>
<para>Install Diffutils by running the following commands:</para>
<para>Prepare Diffutils to be compiled:</para>
<para><screen><userinput>LDFLAGS="-static" CPPFLAGS=-Dre_max_failures=re_max_failures2 \
&nbsp;&nbsp;&nbsp;&nbsp;./configure --prefix=$LFS/static --disable-nls &amp;&amp;
make &amp;&amp;
&nbsp;&nbsp;&nbsp;&nbsp;./configure --prefix=$LFS/static --disable-nls</userinput></screen></para>
<para>The meaning of the configure options are:</para>
<itemizedlist>
<listitem><para><userinput>LDFLAGS="-static":</userinput> This is the most
common way to tell a package that all programs should be statically linked.
This way the <emphasis>LDFLAGS</emphasis> environment variable is set but
only in the subshell that the <filename>configure</filename> script runs
in. When <userinput>configure</userinput> is done its job, the
<emphasis>LDFLAGS</emphasis> variable won't exist
anymore.</para></listitem>
<listitem><para><userinput>CPPFLAGS=-Dre_max_failures=re_max_failures2:</userinput>
The <emphasis>CPPFLAGS</emphasis> variable is a variable that's read by the
cpp program (C PreProcessor). The value of this variable tells the
preprocessor to replace every instance of <emphasis>re_max_failures</emphasis>
it finds with <emphasis>re_max_failures2</emphasis> before handing the source
file to the compiler itself for compilation. This package has problems
linking statically on systems that run an older Glibc version and this
construction fixes that problem.</para></listitem>
</itemizedlist>
<para>Finish off by compiling and installing the package:</para>
<para><screen><userinput>make
make install</userinput></screen></para>
</sect2>

View File

@ -5,10 +5,9 @@
<screen>Estimated build time: &diffutils-time-static;
Estimated required disk space: &diffutils-compsize-static;</screen>
&c5-diffutils-inst;
&c5-diffutils-exp;
&aa-diffutils-desc;
&aa-diffutils-shortdesc;
&aa-diffutils-dep;
&c5-diffutils-inst;
</sect1>

View File

@ -1,10 +0,0 @@
<sect2>
<title>Command explanations</title>
<para><userinput>patch -Np1 -i ../fileutils-&fileutils-version;.patch:</userinput> This is used to fix a problem with building fileutils statically on
glibc 2.2.3 systems. If this isn't done, then there is the possibility of
all of the fileutils programs causing segmentation faults once chroot is
entered in Chapter 6.</para>
</sect2>

View File

@ -1,3 +1,5 @@
<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
<sect2>
<title>Installation of Fileutils</title>
@ -17,7 +19,7 @@ your distribution has altered Glibc-2.2.3 somehow, but details are
unavailable at this time.</para>
<para>To fix this package to compile properly on AMD/Glibc-2.2.3
machines, run the following command. Do <emphasis>not</emphasis>
machines, run the following command. Do <emphasis>NOT</emphasis>
attempt this fix if you don't have Glibc-2.2.3 installed. It will more
than likely result in all kinds of compile time problems.</para>
@ -26,16 +28,15 @@ than likely result in all kinds of compile time problems.</para>
<para>Install Fileutils by running the following commands:</para>
<para><screen><userinput>LDFLAGS="-static" \
&nbsp;&nbsp;&nbsp;&nbsp;./configure --disable-nls --prefix=$LFS/static &amp;&amp;
make &amp;&amp;
&nbsp;&nbsp;&nbsp;&nbsp;./configure --disable-nls --prefix=$LFS/static
make
make install</userinput></screen></para>
<para>Once you have installed Fileutils, you can test whether the
segmentation fault problem has been avoided by running
<userinput>$LFS/static/bin/ls</userinput>. If this works, then you are OK. If
not, then you need to re-do the installation with the patch if
you didn't use it, or without the patch if you did use
it.</para>
not, then you need to re-do the installation with the patch if you didn't
use it, or without the patch if you did use it.</para>
</sect2>

View File

@ -5,10 +5,9 @@
<screen>Estimated build time: &fileutils-time-static;
Estimated required disk space: &fileutils-compsize-static;</screen>
&c5-fileutils-inst;
&c5-fileutils-exp;
&aa-fileutils-desc;
&aa-fileutils-shortdesc;
&aa-fileutils-dep;
&c5-fileutils-inst;
</sect1>

View File

@ -8,6 +8,7 @@
<!ENTITY c6-diffutils-inst SYSTEM "../chapter06/diffutils-inst.xml">
<!ENTITY aa-diffutils SYSTEM "../appendixa/diffutils.xml">
<!ENTITY aa-diffutils-shortdesc SYSTEM "../appendixa/diffutils-shortdesc.xml">
<!ENTITY aa-diffutils-desc SYSTEM "../appendixa/diffutils-desc.xml">
<!ENTITY aa-diffutils-dep SYSTEM "../appendixa/diffutils-dep.xml">
<!ENTITY aa-diffutils-down SYSTEM "../appendixa/diffutils-down.xml">

View File

@ -9,6 +9,7 @@
<!ENTITY c6-fileutils-inst SYSTEM "../chapter06/fileutils-inst.xml">
<!ENTITY aa-fileutils SYSTEM "../appendixa/fileutils.xml">
<!ENTITY aa-fileutils-shortdesc SYSTEM "../appendixa/fileutils-shortdesc.xml">
<!ENTITY aa-fileutils-desc SYSTEM "../appendixa/fileutils-desc.xml">
<!ENTITY aa-fileutils-dep SYSTEM "../appendixa/fileutils-dep.xml">
<!ENTITY aa-fileutils-down SYSTEM "../appendixa/fileutils-down.xml">