icalendar 0.96.4 → 0.97

data/docs/api/files/lib/hash_attrs_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Mon Oct 31 16:38:25 CET 2005</td>
+      <td>Wed Apr 26 10:57:42 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/base_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Mon Oct 31 00:06:23 CET 2005</td>
+      <td>Thu Jun 29 17:55:31 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/calendar_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Sun Oct 30 23:40:28 CET 2005</td>
+      <td>Thu Jul 20 20:03:26 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/component/alarm_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Wed Nov 30 23:27:40 CET 2005</td>
+      <td>Thu Jul 20 20:14:21 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/component/event_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Nov 29 16:07:05 CET 2005</td>
+      <td>Thu Jul 20 20:49:33 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/component/freebusy_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Wed Nov 30 22:30:30 CET 2005</td>
+      <td>Thu Jul 20 20:11:34 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/component/journal_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Nov 29 16:07:39 CET 2005</td>
+      <td>Thu Jul 20 20:11:20 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/component/timezone_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Thu Dec 01 00:16:20 CET 2005</td>
+      <td>Wed Apr 26 10:57:42 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/component/todo_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Nov 29 16:08:11 CET 2005</td>
+      <td>Thu Jul 20 20:11:11 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/component_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Thu Dec 01 00:16:46 CET 2005</td>
+      <td>Thu Jul 20 19:41:55 CEST 2006</td>
     </tr>
     </table>
   </div>
@@ -69,6 +69,13 @@
   <div id="contextContent">
 
 
+    <div id="requires-list">
+      <h3 class="section-bar">Required files</h3>
+
+      <div class="name-list">
+      socket&nbsp;&nbsp;
+      </div>
+    </div>
 
    </div>
 

data/docs/api/files/lib/icalendar/conversions_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Wed Nov 30 23:25:56 CET 2005</td>
+      <td>Thu Jul 20 18:08:51 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/helpers_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Fri Sep 30 13:22:04 CEST 2005</td>
+      <td>Wed Apr 26 10:57:42 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/parameter_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Fri Sep 30 13:22:04 CEST 2005</td>
+      <td>Wed Apr 26 10:57:42 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/icalendar/parser_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Wed Nov 30 19:16:27 CET 2005</td>
+      <td>Thu Jul 20 15:35:13 CEST 2006</td>
     </tr>
     </table>
   </div>
@@ -75,6 +75,7 @@
       <div class="name-list">
       date&nbsp;&nbsp;
       uri&nbsp;&nbsp;
+      stringio&nbsp;&nbsp;
       </div>
     </div>
 

data/docs/api/files/lib/icalendar_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Thu Oct 20 00:15:23 CEST 2005</td>
+      <td>Wed Apr 26 10:57:42 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/files/lib/meta_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Thu Oct 20 00:15:23 CEST 2005</td>
+      <td>Wed Apr 26 10:57:42 CEST 2006</td>
     </tr>
     </table>
   </div>

data/docs/api/fr_class_index.html

@@ -35,6 +35,7 @@
     <a href="classes/Icalendar/Daylight.html">Icalendar::Daylight</a><br />
     <a href="classes/Icalendar/Event.html">Icalendar::Event</a><br />
     <a href="classes/Icalendar/Freebusy.html">Icalendar::Freebusy</a><br />
+    <a href="classes/Icalendar/Geo.html">Icalendar::Geo</a><br />
     <a href="classes/Icalendar/InvalidPropertyValue.html">Icalendar::InvalidPropertyValue</a><br />
     <a href="classes/Icalendar/Journal.html">Icalendar::Journal</a><br />
     <a href="classes/Icalendar/Parameter.html">Icalendar::Parameter</a><br />

data/docs/api/fr_method_index.html

@@ -20,60 +20,76 @@
 <div id="index">
   <h1 class="section-bar">Methods</h1>
   <div id="index-entries">
-    <a href="classes/Icalendar/Component.html#M000028">add (Icalendar::Component)</a><br />
-    <a href="classes/Icalendar/Timezone.html#M000023">add_component (Icalendar::Timezone)</a><br />
-    <a href="classes/Icalendar/Component.html#M000027">add_component (Icalendar::Component)</a><br />
-    <a href="classes/Icalendar/Event.html#M000042">alarm (Icalendar::Event)</a><br />
+    <a href="classes/Icalendar/Component.html#M000031">add (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000030">add_component (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Timezone.html#M000026">add_component (Icalendar::Timezone)</a><br />
+    <a href="classes/Icalendar/Component.html#M000032">add_event (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000034">add_journal (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000033">add_todo (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Event.html#M000053">alarm (Icalendar::Event)</a><br />
     <a href="classes/Icalendar/DateProp.html#M000013">append_features (Icalendar::DateProp)</a><br />
     <a href="classes/Object.html#M000010">class_def (Object)</a><br />
-    <a href="classes/Icalendar/Component.html#M000033">custom_property (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000045">custom_property (Icalendar::Component)</a><br />
     <a href="classes/Icalendar/DateProp/ClassMethods.html#M000014">date_property (Icalendar::DateProp::ClassMethods)</a><br />
-    <a href="classes/Icalendar/Calendar.html#M000044">event (Icalendar::Calendar)</a><br />
-    <a href="classes/Icalendar/Calendar.html#M000047">freebusy (Icalendar::Calendar)</a><br />
-    <a href="classes/HashAttrs.html#M000054">hash_accessor (HashAttrs)</a><br />
-    <a href="classes/HashAttrs.html#M000052">hash_reader (HashAttrs)</a><br />
-    <a href="classes/HashAttrs.html#M000053">hash_writer (HashAttrs)</a><br />
-    <a href="classes/Icalendar/Component.html#M000035">ical_component (Icalendar::Component)</a><br />
-    <a href="classes/Icalendar/Component.html#M000037">ical_multi_property (Icalendar::Component)</a><br />
-    <a href="classes/Icalendar/Component.html#M000036">ical_property (Icalendar::Component)</a><br />
-    <a href="classes/Icalendar/Calendar.html#M000046">journal (Icalendar::Calendar)</a><br />
+    <a href="classes/Icalendar/Base.html#M000022">debug (Icalendar::Base)</a><br />
+    <a href="classes/Icalendar/Calendar.html#M000055">event (Icalendar::Calendar)</a><br />
+    <a href="classes/Icalendar/Calendar.html#M000056">find_event (Icalendar::Calendar)</a><br />
+    <a href="classes/Icalendar/Calendar.html#M000062">find_freebusy (Icalendar::Calendar)</a><br />
+    <a href="classes/Icalendar/Calendar.html#M000060">find_journal (Icalendar::Calendar)</a><br />
+    <a href="classes/Icalendar/Calendar.html#M000058">find_todo (Icalendar::Calendar)</a><br />
+    <a href="classes/Icalendar/Calendar.html#M000061">freebusy (Icalendar::Calendar)</a><br />
+    <a href="classes/HashAttrs.html#M000070">hash_accessor (HashAttrs)</a><br />
+    <a href="classes/HashAttrs.html#M000068">hash_reader (HashAttrs)</a><br />
+    <a href="classes/HashAttrs.html#M000069">hash_writer (HashAttrs)</a><br />
+    <a href="classes/Icalendar/Component.html#M000047">ical_component (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000049">ical_multi_property (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000048">ical_property (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Calendar.html#M000059">journal (Icalendar::Calendar)</a><br />
     <a href="classes/Object.html#M000009">meta_def (Object)</a><br />
     <a href="classes/Object.html#M000007">meta_eval (Object)</a><br />
     <a href="classes/Object.html#M000008">meta_include (Object)</a><br />
     <a href="classes/Object.html#M000006">metaclass (Object)</a><br />
-    <a href="classes/Icalendar/Component.html#M000038">method_missing (Icalendar::Component)</a><br />
-    <a href="classes/Icalendar/Component.html#M000034">multi_property? (Icalendar::Component)</a><br />
-    <a href="classes/Icalendar/Calendar.html#M000043">new (Icalendar::Calendar)</a><br />
-    <a href="classes/Icalendar/Timezone.html#M000025">new (Icalendar::Timezone)</a><br />
-    <a href="classes/Icalendar/Component.html#M000026">new (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000046">multi_property? (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000029">new (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Timezone.html#M000028">new (Icalendar::Timezone)</a><br />
+    <a href="classes/Icalendar/Freebusy.html#M000065">new (Icalendar::Freebusy)</a><br />
+    <a href="classes/Icalendar/Standard.html#M000015">new (Icalendar::Standard)</a><br />
+    <a href="classes/Icalendar/Calendar.html#M000054">new (Icalendar::Calendar)</a><br />
     <a href="classes/Icalendar/Journal.html#M000016">new (Icalendar::Journal)</a><br />
-    <a href="classes/Icalendar/Freebusy.html#M000049">new (Icalendar::Freebusy)</a><br />
-    <a href="classes/Icalendar/Event.html#M000041">new (Icalendar::Event)</a><br />
-    <a href="classes/Icalendar/Daylight.html#M000040">new (Icalendar::Daylight)</a><br />
-    <a href="classes/Icalendar/Alarm.html#M000021">new (Icalendar::Alarm)</a><br />
-    <a href="classes/Icalendar/Todo.html#M000022">new (Icalendar::Todo)</a><br />
+    <a href="classes/Icalendar/Todo.html#M000021">new (Icalendar::Todo)</a><br />
+    <a href="classes/Icalendar/Daylight.html#M000051">new (Icalendar::Daylight)</a><br />
+    <a href="classes/Icalendar/Geo.html#M000024">new (Icalendar::Geo)</a><br />
+    <a href="classes/Icalendar/Alarm.html#M000020">new (Icalendar::Alarm)</a><br />
     <a href="classes/Icalendar/Parser.html#M000017">new (Icalendar::Parser)</a><br />
-    <a href="classes/Icalendar/Standard.html#M000015">new (Icalendar::Standard)</a><br />
+    <a href="classes/Icalendar/Event.html#M000052">new (Icalendar::Event)</a><br />
+    <a href="classes/Icalendar/Component.html#M000040">new_uid (Icalendar::Component)</a><br />
     <a href="classes/Icalendar/Parser.html#M000018">next_line (Icalendar::Parser)</a><br />
-    <a href="classes/Icalendar/Parser.html#M000019">next_line (Icalendar::Parser)</a><br />
-    <a href="classes/Icalendar/Parser.html#M000020">parse (Icalendar::Parser)</a><br />
-    <a href="classes/Icalendar/Component.html#M000030">print_component (Icalendar::Component)</a><br />
-    <a href="classes/Icalendar/Component.html#M000032">print_parameter (Icalendar::Component)</a><br />
-    <a href="classes/Icalendar/Component.html#M000031">print_properties (Icalendar::Component)</a><br />
-    <a href="classes/Icalendar/Component.html#M000039">respond_to? (Icalendar::Component)</a><br />
-    <a href="classes/Icalendar/Calendar.html#M000048">timezone (Icalendar::Calendar)</a><br />
+    <a href="classes/Icalendar/Parser.html#M000019">parse (Icalendar::Parser)</a><br />
+    <a href="classes/Icalendar/Component.html#M000042">print_component (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000044">print_parameters (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000043">print_properties (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Calendar.html#M000064">publish (Icalendar::Calendar)</a><br />
+    <a href="classes/Icalendar/Base.html#M000023">quiet (Icalendar::Base)</a><br />
+    <a href="classes/Icalendar/Component.html#M000036">remove (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000035">remove_component (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000037">remove_event (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000039">remove_journal (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000038">remove_todo (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Component.html#M000050">respond_to? (Icalendar::Component)</a><br />
+    <a href="classes/Icalendar/Calendar.html#M000063">timezone (Icalendar::Calendar)</a><br />
+    <a href="classes/Fixnum.html#M000011">to_ical (Fixnum)</a><br />
+    <a href="classes/Icalendar/Geo.html#M000025">to_ical (Icalendar::Geo)</a><br />
+    <a href="classes/String.html#M000012">to_ical (String)</a><br />
+    <a href="classes/Time.html#M000001">to_ical (Time)</a><br />
     <a href="classes/DateTime.html#M000005">to_ical (DateTime)</a><br />
+    <a href="classes/Icalendar/Timezone.html#M000027">to_ical (Icalendar::Timezone)</a><br />
+    <a href="classes/Icalendar/Component.html#M000041">to_ical (Icalendar::Component)</a><br />
     <a href="classes/Float.html#M000003">to_ical (Float)</a><br />
-    <a href="classes/Time.html#M000001">to_ical (Time)</a><br />
-    <a href="classes/Date.html#M000004">to_ical (Date)</a><br />
     <a href="classes/Array.html#M000002">to_ical (Array)</a><br />
-    <a href="classes/Icalendar/Component.html#M000029">to_ical (Icalendar::Component)</a><br />
-    <a href="classes/String.html#M000012">to_ical (String)</a><br />
-    <a href="classes/Fixnum.html#M000011">to_ical (Fixnum)</a><br />
-    <a href="classes/URI/Generic.html#M000051">to_ical (URI::Generic)</a><br />
-    <a href="classes/Icalendar/Timezone.html#M000024">to_ical (Icalendar::Timezone)</a><br />
-    <a href="classes/Icalendar/Parameter.html#M000050">to_s (Icalendar::Parameter)</a><br />
-    <a href="classes/Icalendar/Calendar.html#M000045">todo (Icalendar::Calendar)</a><br />
+    <a href="classes/URI/Generic.html#M000067">to_ical (URI::Generic)</a><br />
+    <a href="classes/Date.html#M000004">to_ical (Date)</a><br />
+    <a href="classes/Icalendar/Parameter.html#M000066">to_s (Icalendar::Parameter)</a><br />
+    <a href="classes/Icalendar/Calendar.html#M000057">todo (Icalendar::Calendar)</a><br />
   </div>
 </div>
 </body>

data/docs/rfcs/itip_notes.txt

@@ -0,0 +1,69 @@
+Set of methods used for transactions:
+
+PUBLISH:
+- Publish a calendar entry to one or more users.
+
+REQUEST:
+- Used to schedule a calendar entry with other users.
+- Require REPLY messages from others.
+- Used by Organizers to update status of entries.
+
+REPLY:
+- Attendees use this to send information back to Organizers who have sent a
+  REQUEST message.
+
+ADD:
+- Add one or more instances to an existing entry.
+
+CANCEL:
+- Cancel a calendar item.
+
+REFRESH:
+- Attendee's use this to get the latest version of an item.
+
+COUNTER:
+- Used by an attendee to negotiate a change in a calendar entry.
+
+DECLINE-COUNTER:
+- Used by an organizer to decline a COUNTER message.
+
+
+Transports:
+
+Real-time vs. Store-and-forward?
+
+Entry Status:
+- Only the organizer can set the STATUS property
+- Attendee's use the "partstat" parameter of the ATTENDEE property to convey
+  their personal status.
+- Initial value of "partstat" is set to "NEEDS-ACTION" by organizer
+- Modifying this state is part of an attendee's REPLY message.
+
+Sequence Property:
+- Used to tell manage different versions of an entry
+- Has specific rules so look at these
+
+Handling messages should be done in this manner:
+
+1. The primary key for referencing a particular iCalendar component
+   is the "UID" property value. To reference an instance of a
+   recurring component, the primary key is composed of the "UID" and
+   the "RECURRENCE-ID" properties.
+2. The secondary key for referencing a component is the "SEQUENCE"
+   property value. For components where the "UID" is the same, the
+   component with the highest numeric value for the "SEQUENCE"
+   property obsoletes all other revisions of the component with
+   lower values.
+3. "Attendees" send "REPLY" messages to the "Organizer". For
+   replies where the "UID" property value is the same, the value of
+   the "SEQUENCE" property indicates the revision of the component
+   to which the "Attendee" is replying. The reply with the highest
+   numeric value for the "SEQUENCE" property obsoletes all other
+   replies with lower values.
+4. In situations where the "UID" and "SEQUENCE" properties match,
+   the "DTSTAMP" property is used as the tie-breaker. The component
+   with the latest "DTSTAMP" overrides all others. Similarly, for
+   "Attendee" responses where the "UID" property values match and
+   the "SEQUENCE" property values match, the response with the
+   latest "DTSTAMP" overrides all others.
+

data/examples/create_cal.rb

@@ -2,43 +2,44 @@
 ## Need this so we can require the library from the samples directory
 $:.unshift(File.dirname(__FILE__) + '/../lib')
 
+require 'rubygems' # Unless you install from the tarball or zip.
 require 'icalendar'
 require 'date'
 
-# Create a calendar with a single event (Method 1)
-cal = Icalendar::Calendar.new
-event = Icalendar::Event.new
-
-# Set some properties for this event
-event.user_id = "joe-bob@somewhere.net"
-event.timestamp = DateTime.now 
-event.start = Date.new(2005, 04, 29)
-event.end = Date.new(2005, 04, 28)
-event.summary = "Meeting with the man."
-
-# Notice how 'ip_' is prepended for property names that conflict
-# with ruby keywords or methods...
-event.ip_class = "PRIVATE"
-
-# Now add it to the calendar
-cal.add event 
-
-# Create a calendar with a single event (Method 2)
-cal2 = Icalendar::Calendar.new
-event = cal.event  # This automatically adds the event to the calendar
-event.user_id = "joe-bob@somewhere.net"
-event.timestamp = DateTime.now 
-
-# Create a calendar with a single event (Method 3)
-cal3 = Icalendar::Calendar.new
-cal3.event do
-  user_id "joe-bob@somewhere.net"
-  event.timestamp DateTime.now 
+include Icalendar # Probably do this in your class to limit namespace overlap
+
+## Creating calendars and events is easy.
+
+# Create a calendar with an event (standard method)
+cal = Calendar.new
+cal.event do
+  dtstart       Date.new(2005, 04, 29)
+  dtend         Date.new(2005, 04, 28)
+  summary     "Meeting with the man."
+  description "Have a long lunch meeting and decide nothing..."
+  klass       "PRIVATE"
+end
+
+## Or you can make events like this
+event = Event.new
+event.start = DateTime.civil(2006, 6, 23, 8, 30)
+event.summary = "A great event!"
+cal.add_event(event)
+
+event2 = cal.event  # This automatically adds the event to the calendar
+event2.start = DateTime.civil(2006, 6, 24, 8, 30)
+event2.summary = "Another great event!"
+
+# Now with support for property parameters
+params = {"ALTREP" =>['"http://my.language.net"'], "LANGUAGE" => ["SPANISH"]} 
+
+cal.event do
+  dtstart Date.new(2005, 04, 29)
+  dtend   Date.new(2005, 04, 28)
+  summary "This is a summary with params.", params
 end
 
-# We can output the calendars as strings to write to a file, 
+# We can output the calendar as a string to write to a file, 
 # network port, database etc.
 cal_string = cal.to_ical
 puts cal_string
-
-#:startdoc: