diff options
Diffstat (limited to 'chapter06/readline.xml')
| -rw-r--r-- | chapter06/readline.xml | 174 |
1 files changed, 99 insertions, 75 deletions
diff --git a/chapter06/readline.xml b/chapter06/readline.xml index 235f38e8c..f61f934ab 100644 --- a/chapter06/readline.xml +++ b/chapter06/readline.xml @@ -1,111 +1,135 @@ <?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!ENTITY % general-entities SYSTEM "../general.ent"> %general-entities; ]> + <sect1 id="ch-system-readline" role="wrap"> -<title>Readline-&readline-version;</title> -<?dbhtml filename="readline.html"?> + <?dbhtml filename="readline.html"?> + + <title>Readline-&readline-version;</title> + + <indexterm zone="ch-system-readline"> + <primary sortas="a-Readline">Readline</primary> + </indexterm> + + <sect2 role="package"> + <title/> -<indexterm zone="ch-system-readline"><primary sortas="a-Readline">Readline</primary></indexterm> + <para>The Readline package is a set of libraries that offers command-line + editing and history capabilities.</para> -<sect2 role="package"><title/> -<para>The Readline package is a set of libraries that offers command-line -editing and history capabilities.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.11 SBU</seg><seg>9.1 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>0.11 SBU</seg> + <seg>9.1 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Binutils, Coreutils, Diffutils, Gawk, -GCC, Glibc, Grep, Make, Ncurses, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<sect2 role="installation"> -<title>Installation of Readline</title> + <seglistitem> + <seg>Binutils, Coreutils, Diffutils, Gawk, GCC, Glibc, Grep, Make, + Ncurses, and Sed</seg> + </seglistitem> + </segmentedlist> -<para>Prepare Readline for compilation:</para> + </sect2> + + <sect2 role="installation"> + <title>Installation of Readline</title> + + <para>Prepare Readline for compilation:</para> <screen><userinput>./configure --prefix=/usr --libdir=/lib</userinput></screen> -<para>Compile the package:</para> + <para>Compile the package:</para> <screen><userinput>make SHLIB_LIBS=-lncurses</userinput></screen> -<para>The meaning of the make option:</para> + <variablelist> + <title>The meaning of the make option:</title> -<variablelist> -<varlistentry> -<term><parameter>SHLIB_LIBS=-lncurses</parameter></term> -<listitem><para>This option forces Readline to link against the -<filename class="libraryfile">libncurses</filename> -(really, <filename class="libraryfile">libncursesw</filename>) -library.</para></listitem> -</varlistentry> -</variablelist> + <varlistentry> + <term><parameter>SHLIB_LIBS=-lncurses</parameter></term> + <listitem> + <para>This option forces Readline to link against the + <filename class="libraryfile">libncurses</filename> (really, + <filename class="libraryfile">libncursesw</filename>) library.</para> + </listitem> + </varlistentry> -<para>This package does not come with a test suite.</para> + </variablelist> -<para>Install the package:</para> + <para>This package does not come with a test suite.</para> + + <para>Install the package:</para> <screen><userinput>make install</userinput></screen> -<para>Give Readline's dynamic libraries more appropriate permissions:</para> + <para>Give Readline's dynamic libraries more appropriate permissions:</para> <screen><userinput>chmod -v 755 /lib/lib{readline,history}.so*</userinput></screen> -<para>Now move the static libraries to a more appropriate location:</para> + <para>Now move the static libraries to a more appropriate location:</para> <screen><userinput>mv -v /lib/lib{readline,history}.a /usr/lib</userinput></screen> -<para>Next, remove the <filename class="extension">.so</filename> files in -<filename class="directory">/lib</filename> and relink them into <filename -class="directory">/usr/lib</filename>.</para> + <para>Next, remove the <filename class="extension">.so</filename> files in + <filename class="directory">/lib</filename> and relink them into <filename + class="directory">/usr/lib</filename>.</para> <screen><userinput>rm -v /lib/lib{readline,history}.so ln -sfv ../../lib/libreadline.so.5 /usr/lib/libreadline.so ln -sfv ../../lib/libhistory.so.5 /usr/lib/libhistory.so</userinput></screen> -</sect2> - - -<sect2 id="contents-readline" role="content"><title>Contents of Readline</title> -<segmentedlist> -<segtitle>Installed libraries</segtitle> -<seglistitem><seg>libhistory.[a,so], and libreadline.[a,so]</seg></seglistitem> -</segmentedlist> - -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> - -<varlistentry id="libhistory"> -<term><filename class="libraryfile">libhistory</filename></term> -<listitem> -<para>Provides a consistent user interface -for recalling lines of history</para> -<indexterm zone="ch-system-readline libhistory"><primary sortas="c-libhistory">libhistory</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="libreadline"> -<term><filename class="libraryfile">libreadline</filename></term> -<listitem> -<para>Aids in the consistency of user interface -across discrete programs that need to provide a command line -interface</para> -<indexterm zone="ch-system-readline libreadline"><primary sortas="c-libreadline">libreadline</primary></indexterm> -</listitem> -</varlistentry> - -</variablelist> - -</sect2> + </sect2> + + <sect2 id="contents-readline" role="content"> + <title>Contents of Readline</title> + + <segmentedlist> + <segtitle>Installed libraries</segtitle> + + <seglistitem> + <seg>libhistory.[a,so], and libreadline.[a,so]</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="libhistory"> + <term><filename class="libraryfile">libhistory</filename></term> + <listitem> + <para>Provides a consistent user interface for recalling lines + of history</para> + <indexterm zone="ch-system-readline libhistory"> + <primary sortas="c-libhistory">libhistory</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libreadline"> + <term><filename class="libraryfile">libreadline</filename></term> + <listitem> + <para>Aids in the consistency of user interface across discrete + programs that need to provide a command line interface</para> + <indexterm zone="ch-system-readline libreadline"> + <primary sortas="c-libreadline">libreadline</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> </sect1> - |