source: final-system/common/bash.xml@ 0ee0247

Last change on this file since 0ee0247 was 0f06076, checked in by Jim Gifford <clfs@…>, 19 years ago

r3371@server (orig r1554): chris | 2006-05-10 14:03:44 -0700
Removed dependency info from individual package instructions

  • Property mode set to 100644
File size: 4.6 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 </sect2>
23
24 <sect2 role="installation">
25 <title>Installation of Bash</title>
26
27 <para os="a">If you downloaded the Bash documentation tarball and wish to
28 install HTML documentation, issue the following commands:</para>
29
30<screen os="b"><userinput>tar -xvf ../bash-doc-&bash-doc-version;.tar.gz &amp;&amp;
31sed -i "s|htmldir = @htmldir@|htmldir = /usr/share/doc/bash-&bash-version;|" \
32 Makefile.in</userinput></screen>
33
34 <para os="p1">The following patch contains updates from the maintainer. The
35 maintainer of Bash only releases these patches to fix serious issues.</para>
36
37<screen os="p2"><userinput>patch -Np1 -i ../&bash-fixes-patch;</userinput></screen>
38
39 <para os="g">Prepare Bash for compilation:</para>
40
41<screen os="h"><userinput>./configure --prefix=/usr --bindir=/bin \
42 --without-bash-malloc --with-installed-readline</userinput></screen>
43
44 <variablelist os="i">
45 <title>The meaning of the configure option:</title>
46
47 <varlistentry>
48 <term><parameter>--with-installed-readline</parameter></term>
49 <listitem>
50 <para>This option tells Bash to use the
51 <filename class="libraryfile">readline</filename> library that is
52 already installed on the system rather than using its own readline
53 version.</para>
54 </listitem>
55 </varlistentry>
56 </variablelist>
57
58 <para os="j">Compile the package:</para>
59
60<screen os="k"><userinput>make</userinput></screen>
61
62 <para os="l">To test the results, issue:
63 <userinput>make tests</userinput>.</para>
64
65 <para os="m">Install the package:</para>
66
67<screen os="n"><userinput>make install</userinput></screen>
68
69 <para os="o">Run the newly compiled <command>bash</command> program (replacing
70 the one that is currently being executed):</para>
71
72<screen os="p" role="nodump"><userinput>exec /bin/bash --login +h</userinput></screen>
73
74 <note os="q">
75 <para>The parameters used make the <command>bash</command>
76 process an interactive login shell and continue to disable hashing so
77 that new programs are found as they become available.</para>
78 </note>
79
80 </sect2>
81
82 <sect2 id="contents-bash" role="content">
83 <title>Contents of Bash</title>
84
85 <segmentedlist>
86 <segtitle>Installed programs</segtitle>
87
88 <seglistitem>
89 <seg>bash, bashbug, and sh (link to bash)</seg>
90 </seglistitem>
91 </segmentedlist>
92
93 <variablelist>
94 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
95 <?dbfo list-presentation="list"?>
96 <?dbhtml list-presentation="table"?>
97
98 <varlistentry id="bash">
99 <term><command>bash</command></term>
100 <listitem>
101 <para>A widely-used command interpreter; it performs many types of
102 expansions and substitutions on a given command line before executing
103 it, thus making this interpreter a powerful tool</para>
104 <indexterm zone="ch-system-bash bash">
105 <primary sortas="b-bash">bash</primary>
106 </indexterm>
107 </listitem>
108 </varlistentry>
109
110 <varlistentry id="bashbug">
111 <term><command>bashbug</command></term>
112 <listitem>
113 <para>A shell script to help the user compose and mail standard
114 formatted bug reports concerning <command>bash</command></para>
115 <indexterm zone="ch-system-bash bashbug">
116 <primary sortas="b-bashbug">bashbug</primary>
117 </indexterm>
118 </listitem>
119 </varlistentry>
120
121 <varlistentry id="sh">
122 <term><command>sh</command></term>
123 <listitem>
124 <para>A symlink to the <command>bash</command> program; when invoked
125 as <command>sh</command>, <command>bash</command> tries to mimic the
126 startup behavior of historical versions of <command>sh</command> as
127 closely as possible, while conforming to the POSIX standard as
128 well</para>
129 <indexterm zone="ch-system-bash sh">
130 <primary sortas="b-sh">sh</primary>
131 </indexterm>
132 </listitem>
133 </varlistentry>
134
135 </variablelist>
136
137 </sect2>
138
139</sect1>
Note: See TracBrowser for help on using the repository browser.