1. Introduction
---------------

This file gives you some background information how
to run the examples of this small package.

If a Registry wants to send out an announcement, it has
to define a valid XML file with the announcement. This file
will be send to the Registrars and is the "official" 
source of information. Its up to the Registrar what
he is doing with this file.

Because most humans like more readable files than
XML, the XML version can be converted to an ASCII
version, which could be the body of an email to
the Registrars. Additonally the XML file could
also be used to create an iCAL file for calendars.

The dataflow is as follows:

   XML + XSD ---> TXT

   XML + XSD ---> ICAL

This package therefore is more useful for Registries,
which want to convert XML files to TXT or ICAL files.

But it could also be informative to Registrars, how to
handle the XML files and create something they can use.



2. Requirements
---------------

If you want to just see the announcemnts and the results,
produced by this small program, have a look in the examples/sandbox
directory. Everything is cooked already and ready to eat.

If you want to convert the files on your own and play with
the conversation, you need Java 5 in your path. That's all.



3. Run the examples
-------------------

To do the conversion, e.g. for announcement "demo-2", just 
type the following in a shell / cmd window:

   Unix:
      run.sh demo-2

   Windows:
      run.bat demo-2
 
The good examples (valid XML) will produce the txt and ical files.
The bad example (invalid XML) will abort with an error.
