1) Dependencies
---------------

You will need the curl and expat libraries to successfully compile Discover
on your platform.  There has been extensive testing with libcurl 7.9.5 and
expat 1.95.2.  Please let us know if you experience problems with differing
versions (within reason; we don't want to hear about libcurl 0.99.2
failing).

Discover relies on the discover-data package being installed.  The data is
shipped separately from Discover and should be updated far more often than
Discover itself is.

An optional yet useful package is check, which allows unit tests to be run
with the "make check" command from the Discover source directory.  If you
plan to do any development on libdiscover, it is highly recommended you
install check.

Curl:
http://curl.haxx.se/

Expat:
http://www.jclark.com/xml/expat.html

Check:
http://check.sourceforge.net/

Discover-data
http://hackers.progeny.com/discover/


2) Install Instructions
-----------------------

* Overview:
    ./configure
    make
    make install

* Detailed instructions:

By default, Discover will install in the /usr/local directory.  If you want
the install to put Discover elsewhere, use the --prefix=<path> option with
configure.  configure --help will list several additional options not
covered in this document.

By default, Discover will look for the configuration information in
/usr/local/etc/discover and for the data in
/usr/local/share/discover.  This directory should also be the target of
the discover-data install.

Once configure has run successfully, you need to run make.

The makefiles are generated from configure, so editing these by hand is
not recommended.  If you need to make changes to a makefile, the
recommended mechanism is to edit the corresponding Makefile.in and rerun
configure.  This will protect you from losing changes if configure is run
again in the future.

If you want to test your build, the check library must have been found by
configure, and "make check" must be run.  This will use an internal set
of XML data files to verify some library functionality.

To install Discover, issue the "make install" command with the appropriate
permissions (typically as root).  This will place the discover command in
${PREFIX}/bin and the library in ${PREFIX}/lib ($PREFIX defaults to
/usr/local).  Assuming that you have the data installed, you should be able
to run "discover" at this point and see a list of your hardware.  See the
Discover manual for further details.

3) Contact
----------

Feel free to mail questions and comments to:

discover-workers@lists.progeny.com
