Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed

  • BOOK/final-system/common/bash.xml

    r268f64e r61ad0b7f  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE c:package [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../../general.ent">
    45  %general-entities;
    56]>
    67
    7 <c:package xmlns:c="http://schema.cross-lfs.org/book"
    8            id="ch-system-bash" c:multibuild="false">
     8<sect1 id="ch-system-bash" role="wrap">
     9  <?dbhtml filename="bash.html"?>
    910
    10   <c:title>Bash</c:title>
    11   <c:version>&bash-version;</c:version>
    12   <c:description>The Bash package contains the Bourne-Again SHell.</c:description>
     11  <title>Bash-&bash-version;</title>
    1312
    14   <c:install>
     13  <indexterm zone="ch-system-bash">
     14    <primary sortas="a-Bash">Bash</primary>
     15  </indexterm>
    1516
    16     <c:para c:r="p-bu">The following patch contains updates from the maintainer. The
    17     maintainer of Bash only releases these patches to fix serious issues:</c:para>
     17  <sect2 role="package">
     18    <title/>
    1819
    19 <c:command c:r="p-bu">patch -Np1 -i ../&bash-branch_update-patch;</c:command>
     20    <para>The Bash package contains the Bourne-Again SHell.</para>
    2021
    21     <c:para c:multilib="true">The following sed points configure towards the
    22     correct library directory while searching for Readline:</c:para>
     22  </sect2>
    2323
    24 <c:command c:multilib="true">sed -i "/ac_cv_rl_libdir/s@/lib@&amp;64@" configure</c:command>
     24  <sect2 role="installation">
     25    <title>Installation of Bash</title>
    2526
    26     <c:para>Prepare Bash for compilation:</c:para>
     27    <para os="p1">The following patch contains updates from the maintainer. The
     28    maintainer of Bash only releases these patches to fix serious issues:</para>
    2729
    28 <c:command c:multilib="false">./configure --prefix=/usr --bindir=/bin \
    29     --without-bash-malloc --with-installed-readline</c:command>
    30 <c:command c:multilib="true">CC="gcc ${BUILD64}" CXX="g++ ${BUILD64}" \
    31     ./configure --prefix=/usr --bindir=/bin \
    32     --without-bash-malloc --with-installed-readline</c:command>
     30<screen os="p2"><userinput>patch -Np1 -i ../&bash-branch_update-patch;</userinput></screen>
    3331
    34 <!--
    35     <variablelist>
     32    <para os="a">Prepare Bash for compilation:</para>
     33
     34<screen os="b"><userinput>./configure --prefix=/usr --bindir=/bin \
     35    --without-bash-malloc --with-installed-readline</userinput></screen>
     36
     37    <variablelist os="c">
    3638      <title>The meaning of the configure option:</title>
    3739
    3840      <varlistentry>
    39         <term><parameter>-with-installed-readline</parameter></term>
     41        <term><parameter>--with-installed-readline</parameter></term>
    4042        <listitem>
    41           <c:para>This option tells Bash to use the
     43          <para>This option tells Bash to use the
    4244          <filename class="libraryfile">readline</filename> library that is
    4345          already installed on the system rather than using its own readline
    44           version.</c:para>
     46          version.</para>
    4547        </listitem>
    4648      </varlistentry>
    4749    </variablelist>
    48 -->
    49     <c:para>Compile the package:</c:para>
    5050
    51 <c:command>make</c:command>
     51    <para os="d">Compile the package:</para>
    5252
    53     <c:para>To test the results, issue:
    54     <c:command>make tests</c:command>.</c:para>
     53<screen os="e"><userinput>make</userinput></screen>
    5554
    56     <c:para>Install the package:</c:para>
     55    <para os="f">To test the results, issue:
     56    <userinput>make tests</userinput>.</para>
    5757
    58 <c:command>make htmldir=/usr/share/doc/bash-&bash-version; install</c:command>
     58    <para os="g">Install the package:</para>
    5959
    60     <c:para>Run the newly compiled <c:command>bash</c:command> program (replacing
    61     the one that is currently being executed):</c:para>
     60<screen os="h"><userinput>make htmldir=/usr/share/doc/bash-&bash-version; install</userinput></screen>
    6261
    63 <c:command c:nodump="true">exec /bin/bash --login +h</c:command>
     62    <para os="i">Run the newly compiled <command>bash</command> program (replacing
     63    the one that is currently being executed):</para>
    6464
    65     <c:note>
    66       <c:para>The parameters used make the <c:command>bash</c:command>
     65<screen os="j" role="nodump"><userinput>exec /bin/bash --login +h</userinput></screen>
     66
     67    <note os="k">
     68      <para>The parameters used make the <command>bash</command>
    6769      process an interactive login shell and continue to disable hashing so
    68       that new programs are found as they become available.</c:para>
    69     </c:note>
     70      that new programs are found as they become available.</para>
     71    </note>
    7072
    71   </c:install>
     73  </sect2>
    7274
    73   <c:contents>
     75  <sect2 id="contents-bash" role="content">
     76    <title>Contents of Bash</title>
    7477
    75     <c:program>
    76       <c:name>bash</c:name>
    77       <c:description>A widely-used command interpreter; it performs many types
    78       of expansions and substitutions on a given command line before executing
    79       it, thus making this interpreter a powerful tool</c:description>
    80     </c:program>
     78    <segmentedlist>
     79      <segtitle>Installed programs</segtitle>
     80      <segtitle>Installed directory</segtitle>
    8181
    82     <c:program>
    83       <c:name>bashbug</c:name>
    84       <c:description>A shell script to help the user compose and mail standard
    85       formatted bug reports concerning <c:command>bash</c:command>
    86       </c:description>
    87     </c:program>
     82      <seglistitem>
     83        <seg>bash, bashbug, and sh (link to bash)</seg>
     84        <seg>/usr/share/doc/bash-&bash-version;</seg>
     85      </seglistitem>
     86    </segmentedlist>
    8887
    89     <c:program>
    90       <c:name>sh</c:name>
    91       <c:description>A symlink to the <c:command>bash</c:command> program; when
    92       invoked as <c:command>sh</c:command>, <c:command>bash</c:command> tries
    93       to mimic the startup behavior of historical versions of
    94       <c:command>sh</c:command> as closely as possible, while conforming to the
    95       POSIX standard as well</c:description>
    96     </c:program>
     88    <variablelist>
     89      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     90      <?dbfo list-presentation="list"?>
     91      <?dbhtml list-presentation="table"?>
    9792
    98   </c:contents>
     93      <varlistentry id="bash">
     94        <term><command>bash</command></term>
     95        <listitem>
     96          <para>A widely-used command interpreter; it performs many types of
     97          expansions and substitutions on a given command line before executing
     98          it, thus making this interpreter a powerful tool</para>
     99          <indexterm zone="ch-system-bash bash">
     100            <primary sortas="b-bash">bash</primary>
     101          </indexterm>
     102        </listitem>
     103      </varlistentry>
    99104
    100 </c:package>
     105      <varlistentry id="bashbug">
     106        <term><command>bashbug</command></term>
     107        <listitem>
     108          <para>A shell script to help the user compose and mail standard
     109          formatted bug reports concerning <command>bash</command></para>
     110          <indexterm zone="ch-system-bash bashbug">
     111            <primary sortas="b-bashbug">bashbug</primary>
     112          </indexterm>
     113        </listitem>
     114      </varlistentry>
    101115
     116      <varlistentry id="sh">
     117        <term><command>sh</command></term>
     118        <listitem>
     119          <para>A symlink to the <command>bash</command> program; when invoked
     120          as <command>sh</command>, <command>bash</command> tries to mimic the
     121          startup behavior of historical versions of <command>sh</command> as
     122          closely as possible, while conforming to the POSIX standard as
     123          well</para>
     124          <indexterm zone="ch-system-bash sh">
     125            <primary sortas="b-sh">sh</primary>
     126          </indexterm>
     127        </listitem>
     128      </varlistentry>
     129
     130    </variablelist>
     131
     132  </sect2>
     133
     134</sect1>
Note: See TracChangeset for help on using the changeset viewer.