Added Readline

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3492 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

1 files changed, 64 insertions, 0 deletions

diff --git a/chapter06/readline.xml b/chapter06/readline.xml
new file mode 100644
index 000000000..7105a4afa
--- /dev/null
+++ b/chapter06/readline.xml
@@ -0,0 +1,64 @@
+<?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-readline" xreflabel="Readline">
+<title>Readline-&readline-version;</title>
+<?dbhtml filename="readline.html"?>
+
+<indexterm zone="ch-system-readline"><primary sortas="a-Readline">Readline</primary></indexterm>
+
+<para>The Readline package contains the Readline command-line library.</para>
+
+<screen>&buildtime; XXX SBU
+&diskspace; 3.8 MB</screen>
+
+<para>Readline installation depends on: Binutils, Coreutils, Diffutils, Gawk,
+GCC, Glibc, Grep, Make, Ncurses, Sed.</para>
+
+
+<sect2>
+<title>Installation of Readline</title>
+
+<para>Readline has a number of bugs in it that cause it to not behave the 
+way it is expected at times. Fix this behavior with the following
+patch:</para>
+
+<screen><userinput>patch -Np1 -i ../readline-&readline-version;-gnu-fixes-1.patch</userinput></screen>
+
+<para>Now prepare Readline for compilation:</para>
+
+<screen><userinput>./configure --prefix=/usr</userinput></screen>
+
+<para>Compile the package:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>Install the package:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+<para>Give Readline's dynamic libraries to a more appropriate permissions:</para>
+
+<screen><userinput>chmod 644 /usr/lib/*.&readline-version;</userinput></screen>
+
+<para>And move them to a more appropriate location:</para>
+
+<screen><userinput>mv /usr/lib/lib{readline,history}.so.4* /lib</userinput></screen>
+
+<para>Because the libraries have been moved, a few symlinks are now pointing to
+non-existent files. Recreate those symlinks:</para>
+
+<screen><userinput>ln -sf ../../lib/libhistory.so.4 /usr/lib/libhistory.so
+ln -sf ../../lib/libreadline.so.4 /usr/lib/libreadline.so</userinput></screen>
+
+</sect2>
+
+
+<sect2 id="contents-readline"><title>Contents of Readline</title>
+<para><emphasis>Installed libraries</emphasis>: Not checked.</para>
+</sect2>
+
+
+</sect1>