1. Description
==============

XML::Directory - Perl extension to get a content of directory including 
sub-directories as an XML file. The current version is 0.60. See Changes
for a list of recent changes.

2. License
==========

Copyright (c) 2001 Ginger Alliance. All rights reserved. This program is free 
software; you can redistribute it and/or modify it under the same terms as 
Perl itself. 

3. Prerequisites
================

There are no prerequisites for this module. However, if you want to use
the XML::Directory::Apache module, Apache and mod_perl are required.

4. Build and Install
====================

The module builds and installs in a standard way:

	perl Makefile.PL
	make
	make test
	make install

To install on Windows (with ActivePerl), just replace "make" with "nmake".

5. Examples
===========

The examples directory contains examples of scripts using this module.

dir2xml.pl
	command line interface
	Usage: ./dir2xml.pl <directory>

dir2xml_cgi.pl
	CGI/mod_perl interface (requires CGI_Lite)
	Usage: http://<host>/<cgi-bin>/dir2xml_cgi.pl?dir=<directory>

dir2xml_oo.pl
	command line interface using the XML::Directory class
	Usage: ./dir2xml.pl <directory>

dir2xml_sax.pl
	command line interface using the XML::Directory SAX generator
	Usage: ./dir2xml.pl <directory>

MyHandler.pm
	working template of SAX content handler

MyErrorHandler.pm
	working template of SAX error handler

6. To Do
========

- reading RDF description