Initial import of Xylophone code, from the (nominal) v0.1 release.

Author: paulmillar

Documentation/Guide.txt

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!--+ 
+    |  An example of arbitrary dynamic data, as mentioned in the
+    |  README.txt documentation.
+    +-->
+
+<animals>
+  <animal class="bird">
+    <type>African Grey</type>
+    <name>Polly</name>
+  </animal>
+
+  <animal class="bird">
+    <type>Budgerigar</type>
+    <name>Bill</name>
+  </animal>
+
+  <animal class="snake">
+    <type>Ball Python</type>
+    <name>Fred</name>
+  </animal>
+
+  <animal class="dog">
+    <type>Labrador</type>
+    <name>Dexter</name>
+    <colour>Black</colour>
+  </animal>
+</animals>

Documentation/dynamic.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!--+
+    |    This is a "Hello world" example file.  To generate the output
+    |    using xsltproc, you should do:
+    |
+    |       xsltproc xylophone.xsl hello-world.xml
+    |
+    |    The file README.txt contains more information, including a
+    |    description of this file's format and how to use some of the
+    |    other XSLT processors available.
+    +-->
+
+<xylophone>
+  <publish>
+    <object rdn="item">
+      <attr name="item">test</attr>
+      <attr name="message">Hello world!</attr>
+    </object>
+  </publish>
+</xylophone>

Documentation/hello-world.xml

@@ -0,0 +1,26 @@
+Copyright (c) 2008, Paul Millar
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+  o  Redistributions of source code must retain the above copyright
+     notice, this list of conditions and the following disclaimer.
+
+  o  Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in
+     the documentation and/or other materials provided with the
+     distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

License.txt

@@ -0,0 +1,23 @@
+  Xylophone: style-sheets for expressing XML as LDIF.
+
+The project page is available here:
+
+  http://sourceforge.net/projects/xylophone
+
+
+Documentation is available within the file: Documentation/Guide.txt.
+This file describes how to use Xylophone and gives several examples.
+
+A complete, but trivial "hello world" example is provided with the
+file hello-world.xml.  To use it (with xsltproc), do:
+
+  xsltproc xsl/xylophone.xsl Documentation/hello-world.xml
+
+The file Documentation/dynamic.xml is an example "dynamic" file that
+is mentioned in the documentation.  It is included for convenience and
+is not required to use Xylophone.
+
+The XSLT style-sheets are made available under the terms and
+conditions described in the file Licence.txt and at the top of each
+XML file.  In essence, it is a two-clause BSD license.
+