Index: postlfs/filesystems/reiser.xml
===================================================================
--- postlfs/filesystems/reiser.xml	(revision 4967eaf6e8846e5ad1d88a8cda20a7c15d989ff0)
+++ postlfs/filesystems/reiser.xml	(revision 1ba83240eedfcccbf0159e851297b4feaa14c7db)
@@ -4,16 +4,4 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
-
-    <!-- Inserted as a reminder to do this. The mention of a test suite
-         is usually right before the root user installation commands. Please
-         delete these 12 (including one blank) lines after you are done.-->
-
-    <!-- Use one of the two mentions below about a test suite,
-         delete the line that is not applicable. Of course, if the
-         test suite uses syntax other than "make check", revise the
-         line to reflect the actual syntax to run the test suite -->
-
-    <!-- <para>This package does not come with a test suite.</para> -->
-    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
 
   <!ENTITY reiser-download-http "http://ftp.namesys.com/pub/reiserfsprogs/reiserfsprogs-&reiser-version;.tar.gz">
@@ -80,4 +68,6 @@
 <screen><userinput>./configure --prefix=/usr --sbindir=/sbin &amp;&amp;
 make</userinput></screen>
+
+    <para>This package does not come with a test suite.</para>
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
Index: postlfs/filesystems/xfs.xml
===================================================================
--- postlfs/filesystems/xfs.xml	(revision 4967eaf6e8846e5ad1d88a8cda20a7c15d989ff0)
+++ postlfs/filesystems/xfs.xml	(revision 1ba83240eedfcccbf0159e851297b4feaa14c7db)
@@ -5,22 +5,10 @@
   %general-entities;
 
-    <!-- Inserted as a reminder to do this. The mention of a test suite
-         is usually right before the root user installation commands. Please
-         delete these 12 (including one blank) lines after you are done.-->
-
-    <!-- Use one of the two mentions below about a test suite,
-         delete the line that is not applicable. Of course, if the
-         test suite uses syntax other than "make check", revise the
-         line to reflect the actual syntax to run the test suite -->
-
-    <!-- <para>This package does not come with a test suite.</para> -->
-    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
-
-  <!ENTITY xfsprogs-download-http "http://mirrors.sunsite.dk/xfs/download/cmd_tars/xfsprogs-&xfsprogs-version;.src.tar.gz">
-  <!ENTITY xfsprogs-download-ftp  "ftp://oss.sgi.com/projects/xfs/download/cmd_tars/xfsprogs-&xfsprogs-version;.src.tar.gz">
-  <!ENTITY xfsprogs-md5sum        "d4a78fced98c0f3f32627a473e8e0a59">
-  <!ENTITY xfsprogs-size          "878 KB">
-  <!ENTITY xfsprogs-buildsize     "17.3 MB">
-  <!ENTITY xfsprogs-time          "0.78 SBU">
+  <!ENTITY xfsprogs-download-http "http://mirrors.sunsite.dk/xfs/download/cmd_tars/xfsprogs_&xfsprogs-version;-1.tar.gz">
+  <!ENTITY xfsprogs-download-ftp  "ftp://oss.sgi.com/projects/xfs/download/cmd_tars/xfsprogs_&xfsprogs-version;-1.tar.gz">
+  <!ENTITY xfsprogs-md5sum        "6ce9e198cc79ebec6f6fb1f34ffa7709">
+  <!ENTITY xfsprogs-size          "956 KB">
+  <!ENTITY xfsprogs-buildsize     "17.9 MB">
+  <!ENTITY xfsprogs-time          "0.57 SBU">
 ]>
 
@@ -79,13 +67,17 @@
 
 <screen><userinput>sed -i '/autoconf/d' Makefile &amp;&amp;
-make DEBUG=-DNDEBUG</userinput></screen>
+make DEBUG=-DNDEBUG INSTALL_USER=root INSTALL_GROUP=root \
+    LOCAL_CONFIGURE_OPTIONS="--enable-readline=yes"</userinput></screen>
+
+    <para>This package does not come with a test suite.</para>
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install &amp;&amp;
+make install-dev &amp;&amp;
+install -v -m755 -D libhandle/libhandle.la /usr/lib/libhandle.la &amp;&amp;
 chmod -v 755 /lib/libhandle.so* &amp;&amp;
-install -v -m755 -D libhandle/libhandle.la /usr/lib/libhandle.la &amp;&amp;
-install -v -m644 libhandle/.libs/libhandle.a /usr/lib &amp;&amp;
-ln -sv ../../lib/libhandle.so.1 /usr/lib/libhandle.so</userinput></screen>
+rm -f /lib/libhandle.{a,la,so} &amp;&amp;
+ln -svf ../../lib/libhandle.so.1 /usr/lib/libhandle.so</userinput></screen>
 
   </sect2>
@@ -101,15 +93,29 @@
     </application> build will fail using the default -DDEBUG flags.</para>
 
+    <para><parameter>INSTALL_USER=root INSTALL_GROUP=root</parameter>: This
+    sets the owner and group of the installed files.</para>
+    <!-- relevant only if building as non-root -->
+    
+    <para><parameter>LOCAL_CONFIGURE_OPTIONS="..."</parameter>: This passes
+    extra configuration options to the <filename>configure</filename> script.
+    The example <parameter>--enable-readline=yes</parameter> parameter
+    enables linking the XFS programs with the
+    <filename class="libraryfile">libreadline.so</filename> library, in order
+    to allow editing interactive commands.</para>
+    
     <para><parameter>OPTIMIZER="..."</parameter>: Adding this parameter to
-    the <command>make</command> command overrides the default optimization
-    settings.</para>
-
-    <para><command>install -v ...</command>: These commands install the
-    static library and libtool archive for <filename>libhandle</filename>
-    since <command>make install</command> only installs the shared
-    library.</para>
-
-    <para><command>ln -sv ...</command>: This command installs a symlink
-    that is missed by the <command>make install</command> command.</para>
+    the end of the <command>make</command> command overrides the
+    default optimization settings.</para>
+
+    <para><command>make install-dev</command>: This command installs
+    static XFS libraries, their headers and the corresponding documentation.
+    Currently, <ulink url="ftp://oss.sgi.com/projects/xfs/">DMAPI</ulink>
+    and <ulink url="ftp://oss.sgi.com/projects/xfs/">xfsdump</ulink> are
+    the only packages that use the installed libraries.</para>
+    <!-- checked with the Debian package database as of 2007-01-14 -->
+    
+    <para><command>install -v ...</command> and the three following commands
+    fix the installation of <filename class="libraryfile">libhandle</filename>
+    libraries.</para>
 
   </sect2>
@@ -120,5 +126,5 @@
     <segmentedlist>
       <segtitle>Installed Programs</segtitle>
-      <segtitle>Installed Library</segtitle>
+      <segtitle>Installed Libraries</segtitle>
       <segtitle>Installed Directory</segtitle>
 
@@ -126,6 +132,6 @@
         <seg>fsck.xfs, mkfs.xfs, xfs_admin, xfs_bmap, xfs_check, xfs_copy,
         xfs_db, xfs_freeze, xfs_growfs, xfs_info, xfs_io, xfs_logprint,
-        xfs_mkfile, xfs_ncheck, xfs_repair, and xfs_rtcp</seg>
-        <seg>libhandle.{so,a}</seg>
+        xfs_mkfile, xfs_ncheck, xfs_quota, xfs_repair, and xfs_rtcp</seg>
+        <seg>libdisk.a, libhandle.{so,a}, libxcmd.a, libxfs.a, and libxlog.a </seg>
         <seg>/usr/share/doc/xfsprogs</seg>
       </seglistitem>
@@ -318,6 +324,7 @@
         <term><filename class='libraryfile'>libhandle.so</filename></term>
         <listitem>
-          <para>contains functions to map filesystem handles to a
-          corresponding open file descriptor for that filesystem.</para>
+          <para>contains XFS-specific functions that provide a way to perform
+	  certain filesystem  operations without using a file descriptor to
+	  access filesystem objects.</para>
           <indexterm zone="xfs libhandle">
             <primary sortas="c-libhandle">libhandle.so</primary>
@@ -325,4 +332,6 @@
         </listitem>
       </varlistentry>
+      
+      <!-- FIXME: other libraries are undocumented -->
 
     </variablelist>
