first commit

CHANGES

@@ -0,0 +1,63 @@
+Version 1.0.13:
+  - Fixed a bug that led to problems when outputting symbols on Ruby 1.8.x
+    (reported by Chris St. John).
+
+Version 1.0.12:
+  - Works with Ruby 1.9.1, 1.8.x
+  - Accepts compressed XML documents represented by Zlib::GzipReader objects
+    (added by Jay Lawrence).
+  - Added 'AttrPrefix' option (contributed by Reid Morrison).
+
+Version 1.0.11:
+  - Ken Mitchell fixed a bug in option handling.
+
+Version 1.0.10:
+  - Nick Sieger fixed node_to_text.
+
+Version 1.0.9:
+  - Added 'KeyToSymbol' option that converts Tag names to ruby
+    symbols - Keith Veleba
+  - Fixed a bug in markup decoding and encoding. Reported by
+    Yan Zhang.
+
+Version 1.0.6:
+  - Fixed a bug (reported by Curtis Schofield) that led to
+    problems with empty elements that had only attributes.
+
+Version 1.0.5:
+  - Corrected version info in INSTALL file.
+
+Version 1.0.4:
+  - Fixed small bug in install.rb.
+
+Version 1.0.3:
+  - Works with Ruby 1.8.0 and current REXML now.
+
+Version 1.0.2:
+  - All objects can be encoded now by value_to_xml. The Perl
+    version excluded blessed references, but in Ruby each
+    object has a to_s method, so this restriction wasn't
+    necessary. Thanx to Daniel Wu for "pointing" this out.
+
+Version 1.0.1:
+  - Removed a bug (reported by Paul DuBois) that led to a
+    warning in XmlSimple.initialize.
+
+Version 1.0.0:
+  - Added three caching models.
+  - Option names are case insensitive now and underscores
+    are no longer significant, i.e.
+      force_array == ForceArray == forcearray == fOR__CEArray
+  - 'force_array' option additionally works with regexes
+    now.
+  - Added 'indent' option that allows to specify an
+    arbitrary string to be used for indentation by
+    xml_out.
+  - Added 'GroupTags' option.
+  - Added 'Variables' option.
+  - Added 'VarAttr' option.
+  - Added 'NormaliseSpace' option.
+  - Added 'NoIndent' option.
+
+Version 0.6.0:
+  - First working version.

INSTALL

@@ -0,0 +1,21 @@
+XmlSimple installation instructions
+---------------------------------------
+
+Requirements:
+
+- Ruby 1.6.x
+- REXML >= 2.7.1 (standard on Ruby >= 1.8.0)
+
+Installation:
+
+XmlSimple is available as a Gem, so the easiest way to install it
+is to call
+
+  $ gem install xml-simple
+
+If you do not have rubygems installed, try the following:
+
+  $ ruby install.rb config
+  $ ruby install.rb setup
+  $ ruby install.rb install
+

README

@@ -0,0 +1,40 @@
+= XmlSimple - Easy API to maintain XML (especially configuration files)
+
+I have translated the original Perl version of this module (XML::Simple)
+to Ruby, because I often have to work with XML files and the approach
+of XML::Simple was one of the best I have ever seen. It only provides
+two functions (xml_in and xml_out), that let you convert XML strings into
+a nice memory structure and vice versa.
+
+For further information and a really nice tutorial have a look into the
+doc directory of the distribution.
+
+== Installation
+
+See INSTALL.
+
+== Ideas
+
+I still have some ideas for XmlSimple on my "to do" list and I will
+watch the development of the Perl version. If you miss a feature or
+think you have a good idea that would make this library even more
+useful, just let me know.
+
+== Development
+
+Of course, active developers that will improve XmlSimple are
+always welcome. Contact me!
+
+== License
+
+XmlSimple is Copyright (c) 2003-2011 Maik Schmidt. It is free software,
+and may be redistributed under the terms specified in the README file
+of the Ruby distribution.
+
+== Warranty
+
+This software is provided "as is" and without any express or
+implied warranties, including, without limitation, the implied
+warranties of merchantibility and fitness for a particular
+purpose.
+

TODO

@@ -0,0 +1,5 @@
+* Add namespace support.
+* Add strict mode.
+* Add SAX interface?
+* Completely refactor code and make it more Ruby-like.
+