Index: postlfs/editors/editors.xml
===================================================================
--- postlfs/editors/editors.xml	(revision 714d067edf6c5d0ef5e6a6330a505e54990512e4)
+++ postlfs/editors/editors.xml	(revision 9efc5d6916c4dc82ed3470ed07371591b62820e2)
@@ -10,9 +10,9 @@
 <title>Editors</title>
 
-<para>This chapter is referenced in the <acronym>LFS</acronym> book for those 
-wishing to use other editors on their <acronym>LFS</acronym> system.  We
-also have the opportunity to show how some <acronym>LFS</acronym> installed 
-programs benefit from being recompiled after <acronym>GUI</acronym> libraries 
-have been installed.</para>
+<para>This chapter is referenced in the <acronym>LFS</acronym> book for 
+those wishing to use other editors on their <acronym>LFS</acronym> system. 
+You're also shown how some <acronym>LFS</acronym> installed programs 
+benefit from being recompiled after <acronym>GUI</acronym> libraries have 
+been installed.</para>
 
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="vim.xml"/> 
Index: postlfs/editors/vim.xml
===================================================================
--- postlfs/editors/vim.xml	(revision 714d067edf6c5d0ef5e6a6330a505e54990512e4)
+++ postlfs/editors/vim.xml	(revision 9efc5d6916c4dc82ed3470ed07371591b62820e2)
@@ -7,6 +7,6 @@
   <!ENTITY vim-download-http "http://ftp.at.vim.org/pub/vim/unix/vim-&vim-version;.tar.bz2">
   <!ENTITY vim-download-ftp  "ftp://ftp.vim.org/pub/vim/unix/vim-&vim-version;.tar.bz2">
-  <!ENTITY vim-size          "3.2 MB">
-  <!ENTITY vim-buildsize     "46 MB">
+  <!ENTITY vim-size          "3.7 MB">
+  <!ENTITY vim-buildsize     "48 MB">
   <!ENTITY vim-time          "0.59 SBU">
 ]>
@@ -17,11 +17,60 @@
 
 <sect2>
+<title>Introduction to <application>Vim</application></title>
+
+<para>The <application>Vim</application> package, which is an
+abbreviation for VI IMproved, contains a <command>vi</command>
+clone with extra features as compared to the original
+<command>vi</command>.</para>
+
+<para>The default <acronym>LFS</acronym> instructions install 
+<application>vim</application> as a part of the base system. 
+If you would prefer to link <application>vim</application> 
+against <application>X</application>, you should recompile 
+<application>vim</application> to enable <acronym>GUI</acronym> 
+mode. There is no need for special instructions since 
+<application>X</application> support is automatically detected.
+</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&vim-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&vim-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &vim-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&vim-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&vim-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>Vim</application> dependencies</title>
+<sect4><title>Recommended</title>
+<para><application>X</application> 
+(<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
+</sect4>
+
+<sect4><title>Optional</title>
+<para><xref linkend="GTK2"/>, 
+<xref linkend="lesstif"/>, 
+<xref linkend="Python"/>, 
+<xref linkend="tcl"/>, 
+<xref linkend="ruby"/> 
+and <xref linkend="gpm"/>
+</para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
 <title>Installation of <application>Vim</application></title>
 
 <note><para>If you recompile vim to link against <application>X</application>,
-and your X libs are not on the root partition, you will no longer have
-an editor for use in emergencies. You may choose to install an additional editor,
-not link vim against X, or move the current <command>vim</command> executable to the
-<filename>/bin</filename> directory under a different name such as <filename>vi</filename>.</para></note>
+and your <application>X</application> libs are not on the root partition, you 
+will no longer have an editor for use in emergencies. You may choose to 
+install an additional editor, not link vim against X, or move the current 
+<command>vim</command> executable to the <filename>/bin</filename> directory 
+under a different name such as <filename>vi</filename>.</para></note>
 
 <para>Install <application>Vim</application> by running the following commands:</para>
@@ -39,8 +88,9 @@
 <title>Command explanations</title>
 
-<para><parameter>--with-features=huge</parameter>: This switch enables all the additional
-features available in <application>Vim</application>.</para>
+<para><parameter>--with-features=huge</parameter>: This switch enables all 
+the additional features available in <application>Vim</application>.</para>
 
-<para><parameter>--enable-gui=no</parameter>: If you prefer not to link vim against X, use
+<para><parameter>--enable-gui=no</parameter>: If you prefer not to link 
+<application>Vim</application> against <application>X</application>, use
 this switch.</para>
 
@@ -62,5 +112,6 @@
 <command>vim</command> and  start <command>vim</command> with different
 options. <command>vimtutor</command> is a tool to  learn the various
-<command>vim</command> commands and <command>xxd</command> is a command used to create hex dumps.</para>
+<command>vim</command> commands and <command>xxd</command> is a command used 
+to create hex dumps.</para>
 
 </sect2>
