Billy's ed conversion.

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

appendixa/ed-dep.xml

@@ -1,3 +1,5 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Ed Installation Dependencies</title>
 

appendixa/ed-desc.xml

@@ -1,11 +1,10 @@
-<sect2><title>Contents of Ed</title>
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<para>Last checked against version &ed-contversion;.</para>
+<sect2><title>Descriptions</title>
 
-<sect3><title>Program Files</title>
-<para>ed and red (link to ed)</para></sect3>
+<para>Last checked against version &ed-contversion;.</para>
 
-<sect3><title>Description</title>
+<sect3><title>Program file description</title>
 
 <sect4><title>ed</title>
 <para>ed is a line-oriented text editor. It is used to create, display,

appendixa/ed-shortdesc.xml

@@ -0,0 +1,13 @@
+<sect2><title>Contents of Ed</title>
+
+<para>Last checked against version &ed-contversion;.</para>
+
+<para>GNU ed is an 8-bit clean, POSIX-compliant line editor.</para>
+
+<para>Ed installs the following:</para>
+
+<sect3><title>Program Files</title>
+<para>ed and red (link to ed)</para></sect3>
+
+</sect2>
+

appendixa/ed.xml

@@ -3,6 +3,7 @@
 <?dbhtml filename="ed.html" dir="appendixa"?>
 
 &aa-ed-down;
+&aa-ed-shortdesc;
 &aa-ed-desc;
 &aa-ed-dep;
 

chapter06/ed-inst.xml

@@ -1,21 +1,52 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Installation of Ed</title>
 
+<note><para>Ed isn't something you would personally use. It's installed here
+because it can be used by the patch program if you encounter an ed-based patch
+file. This happens rarely because diff-based patches are preferred these
+days.</para></note>
+
 <para>This package requires its patch to be applied before you can
 install it.</para>
 
-<para>Ed isn't something you would personally use. It's installed here
-because it can be used by the patch program if you encounter an ed-based patch
-file. This happens rarely because diff-based patches are preferred these
-days.</para>
+<para><screen><userinput>
+patch -Np1 -i ../ed-&ed-patch-version;.patch
+</userinput></screen></para>
+
+<para>Prepare Ed to be compiled:</para>
+
+<para><screen><userinput>
+./configure --prefix=/usr</userinput></screen></para>
+
+<para>Continue with compiling the package:</para>
+
+<para><screen><userinput>make</userinput></screen></para>
+
+<para>And finish off installing the package:</para>
+
+<para><screen><userinput>make install</userinput></screen></para>
+
+<para>Move the Ed binaries to the root partition.</para>
+
+<para><screen><userinput>mv /usr/bin/{ed,red} /bin
+</userinput></screen></para>
+
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
 
-<para>Install Ed by running the following commands:</para>
+<para><userinput>patch -Np1 -i ../ed-&ed-version;.patch:</userinput> This
+patch fixes a symlink vulnerability in ed. The ed executable creates files
+in /tmp with predictable names. By using various symlink attacks, it is
+possible to have ed write to files it should not, change the permissions
+of files, etc.</para>
 
-<para><screen><userinput>patch -Np1 -i ../ed-&ed-patch-version;.patch &amp;&amp;
-./configure --prefix=/usr &amp;&amp;
-make &amp;&amp;
-make install &amp;&amp;
-mv /usr/bin/{ed,red} /bin</userinput></screen></para>
+<para><userinput>mv /usr/bin/{ed,red} /bin:</userinput>
+The Ed binaries are moved to the /bin directory so they may be used in
+the event that the /usr partition is unavailable.</para>
 
 </sect2>
 

chapter06/ed.xml

@@ -5,10 +5,9 @@
 <screen>Estimated build time:           &ed-time;
 Estimated required disk space:  &ed-compsize;</screen>
 
-&c6-ed-inst;
-&c6-ed-exp;
-&aa-ed-desc;
+&aa-ed-shortdesc;
 &aa-ed-dep;
+&c6-ed-inst;
 
 </sect1>
 

entities/ed.ent

@@ -3,9 +3,9 @@
 
 <!ENTITY c6-ed SYSTEM "../chapter06/ed.xml">
 <!ENTITY c6-ed-inst SYSTEM "../chapter06/ed-inst.xml">
-<!ENTITY c6-ed-exp SYSTEM "../chapter06/ed-exp.xml">
 
 <!ENTITY aa-ed SYSTEM "../appendixa/ed.xml">
+<!ENTITY aa-ed-shortdesc SYSTEM "../appendixa/ed-shortdesc.xml">
 <!ENTITY aa-ed-desc SYSTEM "../appendixa/ed-desc.xml">
 <!ENTITY aa-ed-dep SYSTEM "../appendixa/ed-dep.xml">
 <!ENTITY aa-ed-down SYSTEM "../appendixa/ed-down.xml">