gnucash/lib

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.