History.txt in rubyredrick-ri_cal-0.7.7 vs History.txt in rubyredrick-ri_cal-0.8.0

@@ -1,4 +1,26 @@
+=== 0.8.0 - 11 August 2009
+
+  Minor Version Bump - There is a small potentially breaking change see section on treatment of X-properties below
+
+  * Unknown Components
+
+  Starting with version 0.8.0 RiCal will parse calendars and components which contain nonstandard components.
+
+  For example, there was a short-lived proposal to extend RFC2445 with a new VVENUE component which would hold structured information about the location of an event.  This proposal was never accepted and was withdrawn, but there is icalendar data in the wild which contains VVENUE components.
+
+  Prior to version 0.8.0, RiCal would raise an exception if unknown component types were encountered.  Starting with version 0.8.0 RiCal will 'parse' such components and create instances of NonStandard component to represent them.  Since the actual format of unknown components is not known by RiCal, the NonStandard component will simply save the data lines between the BEGIN:xxx and END:xxx lines, (where xxx is the non-standard component name, e.g. VVENUE).  If the calendar is re-exported the original lines will be replayed.
+
+  * Change to treatment of X-properties
+
+  RFC2445 allows 'non-standard' or experimental properties which property-names beginning with X.  RiCal always supported parsing these.
+
+  The standard properties are specified as to how many times they can occur within a particular component.  For singly occurring properties RiCal returns a single property object, while for properties which can occur multiple times RiCal returns an array of property objects.
+
+  While implementing NonStandard properties, I realized that X-properties were being assumed to be singly occurring. But this isn't necessarily true.  So starting with 0.8.0 the X-properties are represented by an array of property objects.
+
+  THIS MAY BREAK SOME APPLICATIONS, but the adaptation should be easy.
+
 === 0.7.7 - 6 August 2009
    - No changes other than a version number bump.  github seems to have failed to notice the commit of v0.7.6
      and didn't build the gem.  Hopefully it will notice this one.
 === 0.7.6 - 6 August 2009
    - Fixes http://rick_denatale.lighthouseapp.com/projects/30941/tickets/20