source: final-system/common/bash.xml@ cc07a72

Last change on this file since cc07a72 was 75a132b, checked in by Jim Gifford <clfs@…>, 19 years ago

r869@server (orig r867): jim | 2005-12-07 13:30:00 -0800

r1009@server: jim | 2005-12-07 13:20:43 -0800
Upgraded to Bash 3.0.16


  • Property mode set to 100644
File size: 4.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-system-bash" role="wrap">
9 <?dbhtml filename="bash.html"?>
10
11 <title>Bash-&bash-version;</title>
12
13 <indexterm zone="ch-system-bash">
14 <primary sortas="a-Bash">Bash</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Bash package contains the Bourne-Again SHell.</para>
21
22 <segmentedlist>
23 <segtitle>&dependencies;</segtitle>
24
25 <seglistitem>
26 <seg>Binutils, Coreutils, Diffutils, Gawk, GCC, Glibc, Grep, Make,
27 Ncurses, and Sed.</seg>
28 </seglistitem>
29 </segmentedlist>
30
31 </sect2>
32
33 <sect2 role="installation">
34 <title>Installation of Bash</title>
35
36 <para os="a">If you downloaded the Bash documentation tarball and wish to
37 install HTML documentation, issue the following commands:</para>
38
39<screen os="b"><userinput>tar -zxf ../bash-doc-&bash-doc-version;.tar.gz &amp;&amp;
40sed -i "s|htmldir = @htmldir@|htmldir = /usr/share/doc/bash-&bash-version;|" \
41 Makefile.in</userinput></screen>
42
43 <para os="g">Prepare Bash for compilation:</para>
44
45<screen os="h"><userinput>./configure --prefix=/usr --bindir=/bin \
46 --without-bash-malloc --with-installed-readline</userinput></screen>
47
48 <variablelist os="i">
49 <title>The meaning of the configure option:</title>
50
51 <varlistentry>
52 <term><parameter>--with-installed-readline</parameter></term>
53 <listitem>
54 <para>This option tells Bash to use the
55 <filename class="libraryfile">readline</filename> library that is
56 already installed on the system rather than using its own readline
57 version.</para>
58 </listitem>
59 </varlistentry>
60 </variablelist>
61
62 <para os="j">Compile the package:</para>
63
64<screen os="k"><userinput>make</userinput></screen>
65
66 <para os="l">To test the results, issue:
67 <userinput>make tests</userinput>.</para>
68
69 <para os="m">Install the package:</para>
70
71<screen os="n"><userinput>make install</userinput></screen>
72
73 <para os="o">Run the newly compiled <command>bash</command> program (replacing
74 the one that is currently being executed):</para>
75
76<screen os="p"><userinput>exec /bin/bash --login +h</userinput></screen>
77
78 <note os="q">
79 <para>The parameters used make the <command>bash</command>
80 process an interactive login shell and continue to disable hashing so
81 that new programs are found as they become available.</para>
82 </note>
83
84 </sect2>
85
86 <sect2 id="contents-bash" role="content">
87 <title>Contents of Bash</title>
88
89 <segmentedlist>
90 <segtitle>Installed programs</segtitle>
91
92 <seglistitem>
93 <seg>bash, bashbug, and sh (link to bash)</seg>
94 </seglistitem>
95 </segmentedlist>
96
97 <variablelist>
98 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
99 <?dbfo list-presentation="list"?>
100 <?dbhtml list-presentation="table"?>
101
102 <varlistentry id="bash">
103 <term><command>bash</command></term>
104 <listitem>
105 <para>A widely-used command interpreter; it performs many types of
106 expansions and substitutions on a given command line before executing
107 it, thus making this interpreter a powerful tool</para>
108 <indexterm zone="ch-system-bash bash">
109 <primary sortas="b-bash">bash</primary>
110 </indexterm>
111 </listitem>
112 </varlistentry>
113
114 <varlistentry id="bashbug">
115 <term><command>bashbug</command></term>
116 <listitem>
117 <para>A shell script to help the user compose and mail standard
118 formatted bug reports concerning <command>bash</command></para>
119 <indexterm zone="ch-system-bash bashbug">
120 <primary sortas="b-bashbug">bashbug</primary>
121 </indexterm>
122 </listitem>
123 </varlistentry>
124
125 <varlistentry id="sh">
126 <term><command>sh</command></term>
127 <listitem>
128 <para>A symlink to the <command>bash</command> program; when invoked
129 as <command>sh</command>, <command>bash</command> tries to mimic the
130 startup behavior of historical versions of <command>sh</command> as
131 closely as possible, while conforming to the POSIX standard as
132 well</para>
133 <indexterm zone="ch-system-bash sh">
134 <primary sortas="b-sh">sh</primary>
135 </indexterm>
136 </listitem>
137 </varlistentry>
138
139 </variablelist>
140
141 </sect2>
142
143</sect1>
Note: See TracBrowser for help on using the repository browser.