Index: appendixa/ed-dep.xml
===================================================================
--- appendixa/ed-dep.xml	(revision d6871c7bcc47aa34e17173fc9455e5510566c436)
+++ appendixa/ed-dep.xml	(revision c7d30405e2cd7632fa4610d1470a892dfc9e2a1e)
@@ -1,2 +1,4 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Ed Installation Dependencies</title>
Index: appendixa/ed-desc.xml
===================================================================
--- appendixa/ed-desc.xml	(revision d6871c7bcc47aa34e17173fc9455e5510566c436)
+++ appendixa/ed-desc.xml	(revision c7d30405e2cd7632fa4610d1470a892dfc9e2a1e)
@@ -1,10 +1,9 @@
-<sect2><title>Contents of Ed</title>
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
+<sect2><title>Descriptions</title>
 
 <para>Last checked against version &ed-contversion;.</para>
 
-<sect3><title>Program Files</title>
-<para>ed and red (link to ed)</para></sect3>
-
-<sect3><title>Description</title>
+<sect3><title>Program file description</title>
 
 <sect4><title>ed</title>
Index: appendixa/ed-shortdesc.xml
===================================================================
--- appendixa/ed-shortdesc.xml	(revision c7d30405e2cd7632fa4610d1470a892dfc9e2a1e)
+++ appendixa/ed-shortdesc.xml	(revision c7d30405e2cd7632fa4610d1470a892dfc9e2a1e)
@@ -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>
+
Index: appendixa/ed.xml
===================================================================
--- appendixa/ed.xml	(revision d6871c7bcc47aa34e17173fc9455e5510566c436)
+++ appendixa/ed.xml	(revision c7d30405e2cd7632fa4610d1470a892dfc9e2a1e)
@@ -4,4 +4,5 @@
 
 &aa-ed-down;
+&aa-ed-shortdesc;
 &aa-ed-desc;
 &aa-ed-dep;
Index: chapter06/ed-inst.xml
===================================================================
--- chapter06/ed-inst.xml	(revision d6871c7bcc47aa34e17173fc9455e5510566c436)
+++ chapter06/ed-inst.xml	(revision c7d30405e2cd7632fa4610d1470a892dfc9e2a1e)
@@ -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>Install Ed by running the following commands:</para>
+<para>Prepare Ed to be compiled:</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><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><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><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>
+
Index: chapter06/ed.xml
===================================================================
--- chapter06/ed.xml	(revision d6871c7bcc47aa34e17173fc9455e5510566c436)
+++ chapter06/ed.xml	(revision c7d30405e2cd7632fa4610d1470a892dfc9e2a1e)
@@ -6,8 +6,7 @@
 Estimated required disk space:  &ed-compsize;</screen>
 
+&aa-ed-shortdesc;
+&aa-ed-dep;
 &c6-ed-inst;
-&c6-ed-exp;
-&aa-ed-desc;
-&aa-ed-dep;
 
 </sect1>
Index: entities/ed.ent
===================================================================
--- entities/ed.ent	(revision d6871c7bcc47aa34e17173fc9455e5510566c436)
+++ entities/ed.ent	(revision c7d30405e2cd7632fa4610d1470a892dfc9e2a1e)
@@ -4,7 +4,7 @@
 <!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">
