Building instructions for NetBSD
--------------------------------

To build this software, you will need the Expat XML parsing
library. For the time being, grabbing the one from pkgsrc
(textproc/expat) is the simplest solution for most users. If you have
Expat installed in a non-standard location, please set the following
make variables accordingly:

  EXPAT_PREFIX		The root directory where include and lib
  			subdirectories are located. [/usr/pkg]

  EXPAT_INCLUDE		The directory where Expat include files
  			can be found. [${EXPAT_PREFIX}/include]

  EXPAT_LIB		The directory where Expat library files
  			can be found. [${EXPAT_PREFIX}/lib]

To build, just run make in the root directory of the archive:

  $ cd regxml
  $ make

To run the test suite, you will need ATF 0.7 or higher; if you are
tracking NetBSD-5, you will need to get devel/atf from pkgsrc.

Note: For the tests to function properly, the xmltools binaries need
to be in your PATH.

  $ cd tests && atf-run | atf-report

Please read the included man pages. They are located in the doc
subdirectory, at the root of the archive. xmltools(7) gives an
overview of the tool suite, as well as a detailed description of the
pattern language. Each tool also comes with its own man page.


Building instructions for non-NetBSD systems
--------------------------------------------

If for some reason, you have the NetBSD build system installed, by all
mean, please follow the above instructions, replacing the make command
with bmake as appropriate.

If not, your best bet is to try out the simple GNU makefile included
in this distribution. Just invoke GNU make at the root of the
archive. For it to work, you will need the Expat XML parsing library
installed in some standard location on your system.

  $ cd regxml
  $ gmake

This does not compile the documentation. To view the included man
pages, you will need the mdoc roff package, which should be present by
default on most Unix systems:

  $ nroff -mdoc doc/xmltools.7 | $PAGER
  $ nroff -mdoc doc/xmlgrep.1 | $PAGER

xmltools(7) gives an overview of the tool suite, as well as a detailed
description of the pattern language. Each tool also comes with its own
man page.
