From 81fd230419b0cfd052b08fc1ed352bb7d49975df Mon Sep 17 00:00:00 2001
From: Gerard Beekmans <gerard@linuxfromscratch.org>
Date: Sat, 19 Feb 2005 22:16:42 +0000
Subject: Trunk is now identical to Testing

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@4648 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
---
 chapter06/bash.xml | 73 ++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 68 insertions(+), 5 deletions(-)

(limited to 'chapter06/bash.xml')

diff --git a/chapter06/bash.xml b/chapter06/bash.xml
index 8803aad6a..b7c459f1e 100644
--- a/chapter06/bash.xml
+++ b/chapter06/bash.xml
@@ -3,13 +3,14 @@
   <!ENTITY % general-entities SYSTEM "../general.ent">
   %general-entities;
 ]>
-<sect1 id="ch-system-bash" xreflabel="Bash" role="wrap">
+<sect1 id="ch-system-bash" role="wrap">
 <title>Bash-&bash-version;</title>
 <?dbhtml filename="bash.html"?>
 
 <indexterm zone="ch-system-bash"><primary sortas="a-Bash">Bash</primary></indexterm>
 
 <sect2 role="package"><title/>
+<para>The Bash package contains the Bourne-Again SHell.</para>
 
 <segmentedlist>
 <segtitle>&buildtime;</segtitle>
@@ -17,16 +18,24 @@
 <seglistitem><seg>1.2 SBU</seg><seg>27 MB</seg></seglistitem>
 </segmentedlist>
 
+<segmentedlist>
+<segtitle>Bash installation depends on</segtitle>
+<seglistitem><seg>Binutils, Coreutils, Diffutils, Gawk,
+GCC, Glibc, Grep, Make, Ncurses, and Sed.</seg></seglistitem>
+</segmentedlist>
 </sect2>
 
 <sect2 role="installation">
 <title>Installation of Bash</title>
 
-<para>Apply a patch:</para>
+<!-- Edit Me -->
+<para>The following patch fixes various issues, including a problem where Bash
+will sometimes only show 33 characters on a line, then wrap to the next:</para>
 
 <screen><userinput>patch -Np1 -i ../bash-&bash-version;-fixes-1.patch</userinput></screen>
 
-<para>Apply another patch:</para>
+<para>Bash also has issues when compiled against newer versions of Glibc.  The
+following patch resolves this problem:</para>
 
 <screen><userinput>patch -Np1 -i ../bash-&bash-version;-avoid_WCONTINUED-1.patch</userinput></screen>
 
@@ -35,6 +44,17 @@
 <screen><userinput>./configure --prefix=/usr --bindir=/bin \
     --without-bash-malloc --with-installed-readline</userinput></screen>
 
+<para>The meaning of the configure option:</para>
+
+<variablelist>
+<varlistentry>
+<term><parameter>--with-installed-readline</parameter></term>
+<listitem><para>This options tells Bash to use the
+<filename class="libraryfile">readline</filename> library that is already installed 
+on the system rather than using its own readline version.</para></listitem>
+</varlistentry>
+</variablelist>
+
 <para>Compile the package:</para>
 
 <screen><userinput>make</userinput></screen>
@@ -46,17 +66,60 @@
 
 <screen><userinput>make install</userinput></screen>
 
-<para>Run the newly compiled <command>bash</command> program:</para>
+<para>Run the newly compiled <command>bash</command> program (replacing the one that is
+currently being executed):</para>
 
 <screen><userinput>exec /bin/bash --login +h</userinput></screen>
 
+<note><para>The parameters used make the <command>bash</command>
+process an interactive login shell and continue to disable hashing so
+that new programs are found as they become available.</para></note>
+
 </sect2>
 
 
 <sect2 id="contents-bash" role="content"><title>Contents of Bash</title>
 
-<para>See testing</para>
+<segmentedlist>
+<segtitle>Installed programs</segtitle>
+<seglistitem><seg>bash, bashbug, and sh (link to bash)</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="bash">
+<term><command>bash</command></term>
+<listitem>
+<para>A widely-used command interpreter; it performs many types of
+expansions and substitutions on a given command line before executing
+it, thus making this interpreter a powerful tool</para>
+<indexterm zone="ch-system-bash bash"><primary sortas="b-bash">bash</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="bashbug">
+<term><command>bashbug</command></term>
+<listitem>
+<para>A shell script to help the user compose and mail bug reports
+concerning <command>bash</command> in a standard format</para>
+<indexterm zone="ch-system-bash bashbug"><primary sortas="b-bashbug">bashbug</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="sh">
+<term><command>sh</command></term>
+<listitem>
+<para>A symlink to the <command>bash</command> program; when invoked
+as <command>sh</command>, <command>bash</command> tries to mimic the
+startup behavior of historical versions of <command>sh</command> as
+closely as possible, while conforming to the POSIX standard as well</para>
+<indexterm zone="ch-system-bash sh"><primary sortas="b-sh">sh</primary></indexterm>
+</listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
 
 </sect1>
+
-- 
cgit v1.2.3-54-g00ecf