<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<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>
<segtitle>&diskspace;</segtitle>
<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>The following patch is only necessary if Readline was not
installed as suggested.  This patch fixes a problem where Bash
sometimes limits 33 characters to a line before wrapping to the next
line. If Readline has been installed per the instructions, this patch
is not necessary because the patch applied to the Readline package
already resolves this issue.</para>

<screen><userinput>patch -Np1 -i ../bash-&bash-version;-display_wrap-1.patch</userinput></screen>

<para>Prepare Bash for compilation:</para>

<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>

<para>To test the results, issue:
<userinput>make tests</userinput>.</para>

<para>Install the package:</para>

<screen><userinput>make install</userinput></screen>

<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>

<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>

