diff options
Diffstat (limited to 'chapter06/bash.xml')
| -rw-r--r-- | chapter06/bash.xml | 73 |
1 files changed, 68 insertions, 5 deletions
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> + |