diff --git a/lib/Makefile.am b/lib/Makefile.am
index 83a7bf20a3..58dbc9e3ae 100644
--- a/lib/Makefile.am
+++ b/lib/Makefile.am
@@ -1,3 +1,2 @@
-
 EXTRA_DIST = \
   README
diff --git a/lib/Makefile.in b/lib/Makefile.in
index 29e7fb8c29..54e88dd66a 100644
--- a/lib/Makefile.in
+++ b/lib/Makefile.in
@@ -81,7 +81,6 @@ GNOME_CONFIG_BIN = @GNOME_CONFIG_BIN@
 GNOME_LIBS = @GNOME_LIBS@
 GNOME_STATIC_TARGET = @GNOME_STATIC_TARGET@
 GNOME_TARGET = @GNOME_TARGET@
-GTK_XMHTML = @GTK_XMHTML@
 GT_NO = @GT_NO@
 GT_YES = @GT_YES@
 GUILE = @GUILE@
diff --git a/lib/README b/lib/README
index fd24f4c799..866f6a7c0e 100644
--- a/lib/README
+++ b/lib/README
@@ -2,3 +2,48 @@
 This directory is intended to hold any external code that is needed in
 order to build gnucash, but isn't considered widely available.
 
+------------------------------------------------
+
+gtkhtml: gtkhtml is the soon-to-be-released replacement for the
+gtk-xmhtml widget that gnucash has used up to now.  It has a few nifty
+new features.  The most important one for gnucash's purposes is that
+it has direct support for gnome-print, which means that we can now get
+nice-looking printouts of reports and help documents.
+
+It also works as an HTML editor, but I haven't tried that yet; might
+be nice for future stuff like "live" report editing.
+
+YOU HAVE TO BUILD AND INSTALL GTKHTML BEFORE TRYING TO BUILD GNUCASH.   
+
+I suggest that you install it using the same $prefix you use to
+install gnucash.
+
+Building and installing gtkhtml:
+--------------------------------
+
+The default configure options for gtkhtml depend on the 'oaf' and
+'gconf' packages, which are not yet available/functional, and we don't
+need their functionality.  It's important to turn them off in the
+configure step.  --without-gconf turns them both off.
+
+If your gnucash install prefix is $prefix,
+
+   cd gtkhtml 
+   ./autogen.sh --prefix=$prefix --without-bonobo --without-gconf
+   make 
+   make install
+
+   export GNOME_PATH=$prefix
+   
+The 'export GNOME_PATH' is critical if you are installing gtkhtml
+somewhere besides /usr ; without it, the gnome-config script that
+gnucash's configure depends on won't know that gtkhtml is installed.
+
+If you have built and installed gtkhtml correctly, you should be able
+to run the command 'gnome-config --libs gtkhtml' and see some
+semi-meaningful output.  If it reports 'Unknown library gtkhtml' you
+need to make sure GNOME_PATH is set to your $prefix for gtkhtml.
+
+Once gnome-config reports the correct locations for gtkhtml, you can
+go through the normal gnucash configure/build process.
+