added more text in chapter 5, from Make to Texinfo

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2670 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

8 files changed, 126 insertions, 33 deletions

diff --git a/chapter05/gettext-inst.xml b/chapter05/gettext-inst.xml
index c2fcf73c3..4aa9bae58 100644
--- a/chapter05/gettext-inst.xml
+++ b/chapter05/gettext-inst.xml
@@ -3,11 +3,22 @@
 <sect2>
 <title>Installation of Gettext</title>
 
-<para><screen><userinput>./configure --prefix=/stage1
-make
-make check
-make install</userinput></screen></para>
+<para>Prepare Gettext to be compiled:</para>
 
+<para><screen><userinput>./configure --prefix=/stage1</userinput></screen></para>
+
+<para>Compile the programs:</para>
+
+<para><screen><userinput>make </userinput></screen></para>
+
+<para>Check that the programs work correctly (this takes so long you can go
+for a walk):</para>
+
+<para><screen><userinput>make check</userinput></screen></para>
+
+<para>Then install them and their documentation:</para>
+
+<para><screen><userinput>make install</userinput></screen></para>
 
 </sect2>
 
diff --git a/chapter05/grep-inst.xml b/chapter05/grep-inst.xml
index b65737c1c..2364146a7 100644
--- a/chapter05/grep-inst.xml
+++ b/chapter05/grep-inst.xml
@@ -3,12 +3,22 @@
 <sect2>
 <title>Installation of Grep</title>
 
+<para>Prepare Grep to be compiled:</para>
+
 <para><screen><userinput>./configure --prefix=/stage1 \
-&nbsp;&nbsp;&nbsp;&nbsp;--disable-perl-regexp --with-included-regex
-make 
-make check
-make install</userinput></screen></para>
+&nbsp;&nbsp;&nbsp;&nbsp;--disable-perl-regexp --with-included-regex</userinput></screen></para>
+
+<para>Compile the programs:</para>
+
+<para><screen><userinput>make </userinput></screen></para>
+
+<para>Check that the programs work correctly:</para>
+
+<para><screen><userinput>make check</userinput></screen></para>
+
+<para>Then install them and their documentation:</para>
 
+<para><screen><userinput>make install</userinput></screen></para>
 
 </sect2>
 
diff --git a/chapter05/make-inst.xml b/chapter05/make-inst.xml
index 2bd0be489..61b64de51 100644
--- a/chapter05/make-inst.xml
+++ b/chapter05/make-inst.xml
@@ -3,10 +3,21 @@
 <sect2>
 <title>Installation of Make</title>
 
-<para><screen><userinput>./configure --prefix=/stage1
-make
-make check
-make install</userinput></screen></para>
+<para>Prepare Make to be compiled:</para>
+
+<para><screen><userinput>./configure --prefix=/stage1</userinput></screen></para>
+
+<para>Compile the program:</para>
+
+<para><screen><userinput>make </userinput></screen></para>
+
+<para>Test the program:</para>
+
+<para><screen><userinput>make check</userinput></screen></para>
+
+<para>Then install it and its documentation:</para>
+
+<para><screen><userinput>make install</userinput></screen></para>
 
 </sect2>
 
diff --git a/chapter05/ncurses-inst.xml b/chapter05/ncurses-inst.xml
index 7418a7f3b..d7bcb1a66 100644
--- a/chapter05/ncurses-inst.xml
+++ b/chapter05/ncurses-inst.xml
@@ -3,12 +3,31 @@
 <sect2>
 <title>Installation of Ncurses</title>
 
+<para>Fix two minor things:</para>
+
 <para><screen><userinput>patch -Np1 -i ../ncurses-&ncurses-version;-etip-2.patch
-patch -Np1 -i ../ncurses-&ncurses-version;-vsscanf.patch
-./configure --prefix=/stage1 --with-shared --without-debug \
-&nbsp;&nbsp;&nbsp;&nbsp;--without-ada
-make
-make install
-chmod 755 /stage1/lib/*.5.3</userinput></screen></para>
+patch -Np1 -i ../ncurses-&ncurses-version;-vsscanf.patch</userinput></screen></para>
+
+<para>The first patch corrects the <filename>etip.h</filename> header file, and
+the second patch prevents some compiler warnings being issued on the use of
+deprecated headers.</para>
+
+<para>Now prepare Ncurses to be compiled:</para>
+
+<para><screen><userinput>./configure --prefix=/stage1 --with-shared \
+&nbsp;&nbsp;&nbsp;&nbsp;--without-debug --without-ada</userinput></screen></para>
+
+<para>Compile the programs and libraries:</para>
+
+<para><screen><userinput>make </userinput></screen></para>
+
+<para>Then install them and their documentation:</para>
+
+<para><screen><userinput>make install</userinput></screen></para>
+
+<para>And make some of the libraries executable:</para>
+
+<para><screen><userinput>chmod 755 /stage1/lib/*.5.3</userinput></screen></para>
+
 </sect2>
 
diff --git a/chapter05/patch-inst.xml b/chapter05/patch-inst.xml
index ba9302d2e..bdc9f9fb8 100644
--- a/chapter05/patch-inst.xml
+++ b/chapter05/patch-inst.xml
@@ -3,10 +3,20 @@
 <sect2>
 <title>Installation of Patch</title>
 
-<para><screen><userinput>CPPFLAGS=-D_GNU_SOURCE ./configure --prefix=/stage1
-make 
-make install</userinput></screen></para>
+<para>Prepare Patch to be compiled:</para>
 
+<para><screen><userinput>CPPFLAGS=-D_GNU_SOURCE ./configure --prefix=/stage1</userinput></screen></para>
+
+<para>The preprocessor flag <userinput>-D_GNU_SOURCE</userinput> is only needed
+on the PowerPC platform. On other architectures you can leave it out.</para>
+
+<para>Compile the program:</para>
+
+<para><screen><userinput>make </userinput></screen></para>
+
+<para>Then install it and its documentation:</para>
+
+<para><screen><userinput>make install</userinput></screen></para>
 
 </sect2>
 
diff --git a/chapter05/sed-inst.xml b/chapter05/sed-inst.xml
index d17835336..79ccf256c 100644
--- a/chapter05/sed-inst.xml
+++ b/chapter05/sed-inst.xml
@@ -3,10 +3,21 @@
 <sect2>
 <title>Installation of Sed</title>
 
-<para><screen><userinput>./configure --prefix=/stage1
-make 
-make check
-make install</userinput></screen></para>
+<para>Prepare Sed to be compiled:</para>
+
+<para><screen><userinput>./configure --prefix=/stage1</userinput></screen></para>
+
+<para>Compile the program:</para>
+
+<para><screen><userinput>make </userinput></screen></para>
+
+<para>Test the program:</para>
+
+<para><screen><userinput>make check</userinput></screen></para>
+
+<para>Then install it and its documentation:</para>
+
+<para><screen><userinput>make install</userinput></screen></para>
 
 </sect2>
 
diff --git a/chapter05/tar-inst.xml b/chapter05/tar-inst.xml
index 9c94af6df..3a17903e7 100644
--- a/chapter05/tar-inst.xml
+++ b/chapter05/tar-inst.xml
@@ -3,10 +3,21 @@
 <sect2>
 <title>Installation of Tar</title>
 
-<para><screen><userinput>./configure --prefix=/stage1
-make 
-make check
-make install</userinput></screen></para>
+<para>Prepare Tar to be compiled:</para>
+
+<para><screen><userinput>./configure --prefix=/stage1</userinput></screen></para>
+
+<para>Compile the programs:</para>
+
+<para><screen><userinput>make </userinput></screen></para>
+
+<para>Check that the programs work correctly:</para>
+
+<para><screen><userinput>make check</userinput></screen></para>
+
+<para>Then install them and their documentation:</para>
+
+<para><screen><userinput>make install</userinput></screen></para>
 
 </sect2>
 
diff --git a/chapter05/texinfo-inst.xml b/chapter05/texinfo-inst.xml
index c2d27a5bf..0249cd361 100644
--- a/chapter05/texinfo-inst.xml
+++ b/chapter05/texinfo-inst.xml
@@ -3,11 +3,21 @@
 <sect2>
 <title>Installation of Texinfo</title>
 
-<para><screen><userinput>./configure --prefix=/stage1
-make 
-make check
-make install</userinput></screen></para>
+<para>Prepare Texinfo to be compiled:</para>
 
+<para><screen><userinput>./configure --prefix=/stage1</userinput></screen></para>
+
+<para>Compile the programs:</para>
+
+<para><screen><userinput>make </userinput></screen></para>
+
+<para>Check that the programs work correctly:</para>
+
+<para><screen><userinput>make check</userinput></screen></para>
+
+<para>Then install them and their documentation:</para>
+
+<para><screen><userinput>make install</userinput></screen></para>
 
 </sect2>