cal-client/cal-client.[hc] cal-util/cal-component.c

2001-07-03  Damon Chaplin  <damon@ximian.com>

	* cal-client/cal-client.[hc]
	* cal-util/cal-component.c
	* cal-util/cal-recur.[hc]
	* cal-util/test-recur.c
	* cal-util/timeutil.c
	* gui/calendar-config.c
	* gui/calendar-model.[hc]
	* gui/comp-util.[hc]
	* gui/e-calendar-table.c
	* gui/e-day-view-main-item.c
	* gui/e-day-view-top-item.c
	* gui/e-day-view.[hc]
	* gui/e-itip-control.c
	* gui/e-timezone-entry.[hc]
	* gui/e-week-view.[hc]
	* gui/gnome-cal.[hc]
	* gui/goto.c
	* gui/tag-calendar.[hc]
	* gui/dialogs/cal-prefs-dialog.c
	* gui/dialogs/comp-editor-page.[hc]
	* gui/dialogs/comp-editor-util.[hc]
	* gui/dialogs/comp-editor.c
	* gui/dialogs/e-timezone-dialog.[hc]
	* gui/dialogs/event-page.c
	* gui/dialogs/meeting-page.c
	* gui/dialogs/recurrence-page.c
	* gui/dialogs/task-details-page.c
	* gui/dialogs/task-details-page.glade
	* gui/dialogs/task-page.c
	* idl/evolution-calendar.idl
	* pcs/cal-backend-file.c
	* pcs/cal-backend.c
	* pcs/cal-backend.h
	* pcs/cal.c
	* pcs/query.c: timezone changes everywhere. There's still quite a
	few things to update, and its not working well at present.

svn path=/trunk/; revision=10729

1 files changed, 21 insertions, 1 deletions

diff --git a/calendar/idl/evolution-calendar.idl b/calendar/idl/evolution-calendar.idl
index 5f0d10513f..a855f09cce 100644
--- a/calendar/idl/evolution-calendar.idl
+++ b/calendar/idl/evolution-calendar.idl
@@ -28,6 +28,12 @@ module Calendar {
 	/* Sequence of unique identifiers */
 	typedef sequence<CalObjUID> CalObjUIDSeq;
 
+	/* A VTIMEZONE component, represented as an iCalendar string. */
+	typedef string CalTimezoneObj;
+
+	/* A unique identifier for a VTIMEZONE component, i.e. its TZID. */
+	typedef string CalTimezoneObjUID;
+
 	/* A unique identifier for an alarm subcomponent */
 	typedef string CalAlarmUID;
 
@@ -123,6 +129,10 @@ module Calendar {
 		CalObj getObject (in CalObjUID uid)
 			raises (NotFound);
 
+		/* Gets a VTIMEZONE component based on its TZID */
+		CalTimezoneObj getTimezoneObject (in CalTimezoneObjUID tzid)
+			raises (NotFound);
+
 		/* Gets a list of UIDs based on component type */
 		CalObjUIDSeq getUIDs (in CalObjType type);
 
@@ -153,7 +163,17 @@ module Calendar {
 
 
 		/* Updates a component by adding it if it does not exist or by
-		 * changing an existing one.  
+		 * changing an existing one. This can be a simple VEVENT/VTODO
+		 * object if no timezone data is needed for the component or
+		 * it hasn't changed. To add or change the associated VTIMEZONE
+		 * data the calobj should be a VCALENDAR component with
+		 * VTIMEZONE and VEVENT/VTODO subcomponents. The VTIMEZONE data
+		 * will be merged into the calendar, possibly by renaming TZIDs
+		 * (though not for builtin VTIMEZONEs), so don't rely on the
+		 * TZIDs being the same in the new object on the server.
+		 * The client should probably immediately free its copy of the
+		 * object after this call, and call getObject to get the
+		 * updated version.
 		 */
 		void updateObject (in CalObjUID uid, in CalObj calobj)
 			raises (InvalidObject);