From 3532a74349645ca733bafe1417822ba2bfb9bd26 Mon Sep 17 00:00:00 2001 From: JP Rosevear Date: Fri, 19 Jan 2001 14:57:09 +0000 Subject: create a new cal component alarm (cal_component_add_alarm): add alarm to 2001-01-19 JP Rosevear * cal-util/cal-component.c (cal_component_alarm_new): create a new cal component alarm (cal_component_add_alarm): add alarm to the cal component (cal_component_remove_alarm): remove alarm from the cal component (remove_alarm): remove alarm from hash * cal-util/cal-component.h: new protos * conduits/calendar/calendar-conduit.c (comp_from_remote_record): add alarm information, still needs to be hacked to replace an already existing alarm. questions abound about the heuristic for doing this. 2001-01-17 JP Rosevear * README: Update package requirements svn path=/trunk/; revision=7647 --- ChangeLog | 4 + README | 6 +- calendar/ChangeLog | 19 ++ calendar/cal-util/cal-component.c | 176 +++++++++++--- calendar/cal-util/cal-component.h | 10 +- calendar/conduits/calendar/calendar-conduit.c | 27 +++ .../tmpl/evolution-cal-client-unused.sgml | 42 ++-- .../calendar/cal-util/evolution-cal-util-decl.txt | 269 +++++++++++---------- .../cal-util/tmpl/evolution-cal-util-unused.sgml | 164 ++++++------- .../tmpl/evolution-cal-client-unused.sgml | 42 ++-- .../calendar/cal-util/evolution-cal-util-decl.txt | 269 +++++++++++---------- .../cal-util/tmpl/evolution-cal-util-unused.sgml | 164 ++++++------- 12 files changed, 688 insertions(+), 504 deletions(-) diff --git a/ChangeLog b/ChangeLog index f3adc70e65..b35b232929 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2001-01-17 JP Rosevear + + * README: Update package requirements + 2001-01-19 Jason Leach * configure.in: Changed a leftover $with_x_mailer to diff --git a/README b/README index adb203aa04..cbda0405f3 100644 --- a/README +++ b/README @@ -105,7 +105,7 @@ and -devel packages for each library. - gdk-pixbuf - 0.8.0 or later (*) - - ORBit - 0.5.5 or later (*) (If you get this from GNOME CVS, use the + - ORBit - 0.5.6 or later (*) (If you get this from GNOME CVS, use the tag "orbit-stable-0-5".) - oaf - 0.6.0 or later (If you get this from GNOME CVS, use the tag @@ -115,7 +115,7 @@ and -devel packages for each library. *** "--disable-more-warnings" when configure, or it may fail to *** build. - - gnome-vfs - 0.3 or later + - gnome-vfs - 0.4.2 or later *** If you are using gnome-vfs from CVS, you should use the flag *** "--disable-more-warnings" when configuring, or it may fail to @@ -132,7 +132,7 @@ and -devel packages for each library. - gconf - 0.6 or later - - gal (GNOME Application Library) - 0.4 or later + - gal (GNOME Application Library) - 0.4.99.4 or later - gtkhtml - 0.8 or later diff --git a/calendar/ChangeLog b/calendar/ChangeLog index caab58dc82..059dc4cd02 100644 --- a/calendar/ChangeLog +++ b/calendar/ChangeLog @@ -1,3 +1,22 @@ +2001-01-19 JP Rosevear + + * cal-util/cal-component.c (cal_component_alarm_new): create a new + cal component alarm + (cal_component_add_alarm): add alarm to the cal component + (cal_component_remove_alarm): remove alarm from the cal component + (remove_alarm): remove alarm from hash + + * cal-util/cal-component.h: new protos + + * conduits/calendar/calendar-conduit.c (comp_from_remote_record): + add alarm information, still needs to be hacked to replace an already + existing alarm. questions abound about the heuristic for doing this. + +2001-01-17 JP Rosevear + + * gui/event-editor.c (dialog_to_comp_object): Properly set categories + to NULL if there are none + 2001-01-18 Federico Mena Quintero * gui/tasks-migrate.[ch]: New files with a simple sequence to diff --git a/calendar/cal-util/cal-component.c b/calendar/cal-util/cal-component.c index daf50600c8..7b61aab7f5 100644 --- a/calendar/cal-util/cal-component.c +++ b/calendar/cal-util/cal-component.c @@ -688,6 +688,17 @@ add_alarm (CalComponent *comp, icalcomponent *alarm, const char *auid) return auid; } +static void +remove_alarm (CalComponent *comp, const char *auid) +{ + CalComponentPrivate *priv; + + priv = comp->priv; + + g_hash_table_remove (priv->alarm_uid_hash, auid); +} + + /* Scans an alarm subcomponent, adds an UID extension property to it (so that we * can reference alarms by unique IDs), and adds its mapping to the component. */ static void @@ -3442,6 +3453,66 @@ cal_component_has_alarms (CalComponent *comp) return g_hash_table_size (priv->alarm_uid_hash) != 0; } +void +cal_component_add_alarm (CalComponent *comp, CalComponentAlarm *alarm) +{ + CalComponentPrivate *priv; + + g_return_if_fail (comp != NULL); + g_return_if_fail (IS_CAL_COMPONENT (comp)); + g_return_if_fail (alarm != NULL); + + priv = comp->priv; + + alarm->parent = comp; + add_alarm (comp, alarm->icalcomp, icalproperty_get_x (alarm->uid)); + icalcomponent_add_component (priv->icalcomp, alarm->icalcomp); +} + +void +cal_component_remove_alarm (CalComponent *comp, const char *auid) +{ + CalComponentPrivate *priv; + icalcompiter iter; + + g_return_if_fail (comp != NULL); + g_return_if_fail (IS_CAL_COMPONENT (comp)); + g_return_if_fail (auid != NULL); + + priv = comp->priv; + + for (iter = icalcomponent_begin_component (priv->icalcomp, ICAL_VALARM_COMPONENT); + icalcompiter_deref (&iter) != NULL; + icalcompiter_next (&iter)) { + icalproperty *prop; + icalcomponent *subcomp; + + subcomp = icalcompiter_deref (&iter); + for (prop = icalcomponent_get_first_property (subcomp, ICAL_X_PROPERTY); + prop; + prop = icalcomponent_get_next_property (subcomp, ICAL_X_PROPERTY)) { + const char *xname; + const char *alarm_uid; + + xname = icalproperty_get_x_name (prop); + g_assert (xname != NULL); + + if (strcmp (xname, EVOLUTION_ALARM_UID_PROPERTY) == 0) { + alarm_uid = alarm_uid_from_prop (prop); + if (strcmp (alarm_uid, auid) == 0) { + remove_alarm (comp, auid); + icalcomponent_remove_component (priv->icalcomp, subcomp); + icalcomponent_free (subcomp); + break; + } + + return; + } + } + } +} + + /* Scans an icalproperty from a calendar component and adds its mapping to our * own alarm structure. */ @@ -3573,30 +3644,6 @@ cal_component_get_alarm (CalComponent *comp, const char *auid) return NULL; } -/** - * cal_component_alarm_free: - * @alarm: A calendar alarm. - * - * Frees an alarm structure. - **/ -void -cal_component_alarm_free (CalComponentAlarm *alarm) -{ - g_return_if_fail (alarm != NULL); - - g_assert (alarm->icalcomp != NULL); - - if (icalcomponent_get_parent (alarm->icalcomp) != NULL) - icalcomponent_free (alarm->icalcomp); - - alarm->icalcomp = NULL; - - alarm->parent = NULL; - alarm->action = NULL; - - g_free (alarm); -} - /** * cal_component_alarms_free: * @alarms: Component alarms structure. @@ -3625,6 +3672,30 @@ cal_component_alarms_free (CalComponentAlarms *alarms) g_free (alarms); } +/** + * cal_component_alarm_new: + * + * + * + * Return value: a new alarm component + **/ +CalComponentAlarm * +cal_component_alarm_new (void) +{ + CalComponentAlarm *alarm = g_new0 (CalComponentAlarm, 1); + char *new_auid ; + + alarm->icalcomp = icalcomponent_new (ICAL_VALARM_COMPONENT); + + new_auid = cal_component_gen_uid (); + alarm->uid = icalproperty_new_x (new_auid); + icalproperty_set_x_name (alarm->uid, EVOLUTION_ALARM_UID_PROPERTY); + icalcomponent_add_property (alarm->icalcomp, alarm->uid); + g_free (new_auid); + + return alarm; +} + /** * cal_component_alarm_get_uid: * @alarm: An alarm subcomponent. @@ -3844,12 +3915,14 @@ cal_component_alarm_set_trigger (CalComponentAlarm *alarm, CalAlarmTrigger trigg switch (trigger.type) { case CAL_ALARM_TRIGGER_RELATIVE_START: t.duration = trigger.u.rel_duration; + t.time.is_date = -1; value_type = ICAL_DURATION_VALUE; related = ICAL_RELATED_START; break; case CAL_ALARM_TRIGGER_RELATIVE_END: t.duration = trigger.u.rel_duration; + t.time.is_date = -1; value_type = ICAL_DURATION_VALUE; related = ICAL_RELATED_END; break; @@ -3891,6 +3964,46 @@ cal_component_alarm_set_trigger (CalComponentAlarm *alarm, CalAlarmTrigger trigg } } +/** + * cal_component_alarm_free: + * @alarm: A calendar alarm. + * + * Frees an alarm structure. + **/ +void +cal_component_alarm_free (CalComponentAlarm *alarm) +{ + g_return_if_fail (alarm != NULL); + + g_assert (alarm->icalcomp != NULL); + + if (icalcomponent_get_parent (alarm->icalcomp) != NULL) + icalcomponent_free (alarm->icalcomp); + + alarm->icalcomp = NULL; + + alarm->parent = NULL; + alarm->action = NULL; + + g_free (alarm); +} + + +/* Returns TRUE if both strings match, i.e. they are both NULL or the + strings are equal. */ +static gboolean +cal_component_strings_match (const gchar *string1, + const gchar *string2) +{ + if (string1 == NULL || string2 == NULL) + return (string1 == string2) ? TRUE : FALSE; + + if (!strcmp (string1, string2)) + return TRUE; + + return FALSE; +} + /** * cal_component_event_dates_match: @@ -3947,19 +4060,4 @@ cal_component_event_dates_match (CalComponent *comp1, } -/* Returns TRUE if both strings match, i.e. they are both NULL or the - strings are equal. */ -static gboolean -cal_component_strings_match (const gchar *string1, - const gchar *string2) -{ - if (string1 == NULL || string2 == NULL) - return (string1 == string2) ? TRUE : FALSE; - - if (!strcmp (string1, string2)) - return TRUE; - - return FALSE; -} - diff --git a/calendar/cal-util/cal-component.h b/calendar/cal-util/cal-component.h index b7d8b602e9..97b518dfe2 100644 --- a/calendar/cal-util/cal-component.h +++ b/calendar/cal-util/cal-component.h @@ -327,13 +327,17 @@ typedef struct { } CalAlarmTrigger; gboolean cal_component_has_alarms (CalComponent *comp); +void cal_component_add_alarm (CalComponent *comp, CalComponentAlarm *alarm); +void cal_component_remove_alarm (CalComponent *comp, const char *auid); + GList *cal_component_get_alarm_uids (CalComponent *comp); CalComponentAlarm *cal_component_get_alarm (CalComponent *comp, const char *auid); -void cal_component_alarm_free (CalComponentAlarm *alarm); - void cal_component_alarms_free (CalComponentAlarms *alarms); +/* CalComponentAlarms */ +CalComponentAlarm *cal_component_alarm_new (void); + const char *cal_component_alarm_get_uid (CalComponentAlarm *alarm); void cal_component_alarm_get_action (CalComponentAlarm *alarm, CalAlarmAction *action); @@ -342,6 +346,8 @@ void cal_component_alarm_set_action (CalComponentAlarm *alarm, CalAlarmAction ac void cal_component_alarm_get_trigger (CalComponentAlarm *alarm, CalAlarmTrigger *trigger); void cal_component_alarm_set_trigger (CalComponentAlarm *alarm, CalAlarmTrigger trigger); +void cal_component_alarm_free (CalComponentAlarm *alarm); + diff --git a/calendar/conduits/calendar/calendar-conduit.c b/calendar/conduits/calendar/calendar-conduit.c index 868d7bddd7..9b820ef1d3 100644 --- a/calendar/conduits/calendar/calendar-conduit.c +++ b/calendar/conduits/calendar/calendar-conduit.c @@ -655,6 +655,33 @@ comp_from_remote_record (GnomePilotConduitSyncAbs *conduit, } else { cal_component_set_rrule_list (comp, NULL); } + + /* Alarm information */ + if (appt.alarm) { + CalComponentAlarm *alarm; + CalAlarmTrigger trig; + + alarm = cal_component_alarm_new (); + cal_component_add_alarm (comp, alarm); + + memset (&trig, 0, sizeof (trig)); + trig.type = CAL_ALARM_TRIGGER_RELATIVE_START; + trig.u.rel_duration.is_neg = 1; + switch (appt.advanceUnits) { + case advMinutes: + trig.u.rel_duration.minutes = appt.advance; + break; + case advHours: + trig.u.rel_duration.hours = appt.advance; + break; + case advDays: + trig.u.rel_duration.days = appt.advance; + break; + } + cal_component_alarm_set_trigger (alarm, trig); + + cal_component_alarm_set_action (alarm, CAL_ALARM_AUDIO); + } cal_component_set_transparency (comp, CAL_COMPONENT_TRANSP_NONE); diff --git a/doc/devel/calendar/cal-client/tmpl/evolution-cal-client-unused.sgml b/doc/devel/calendar/cal-client/tmpl/evolution-cal-client-unused.sgml index 56bcf3aff5..f8f1f1408e 100644 --- a/doc/devel/calendar/cal-client/tmpl/evolution-cal-client-unused.sgml +++ b/doc/devel/calendar/cal-client/tmpl/evolution-cal-client-unused.sgml @@ -1,14 +1,13 @@ - + @client: -@uid: -@pilot_id: -@pilot_status: +@str_uri: +@Returns: - + @@ -17,19 +16,6 @@ @str_uri: @Returns: - - - These values describe the status of a calendar load or create - request. After asking a calendar factory to load or create a - calendar, the provided listener will get notification about the - result in asynchronous fashion. Such notification is represented - by one of these enumeration values. For values other than - #CAL_CLIENT_LOAD_SUCCESS, the #CalClient object will not accept - any other operations on the calendar and it should just be - destroyed. - - - @@ -63,14 +49,28 @@ @client: @Returns: - + @client: -@str_uri: -@Returns: +@uid: +@pilot_id: +@pilot_status: + + + + These values describe the status of a calendar load or create + request. After asking a calendar factory to load or create a + calendar, the provided listener will get notification about the + result in asynchronous fashion. Such notification is represented + by one of these enumeration values. For values other than + #CAL_CLIENT_LOAD_SUCCESS, the #CalClient object will not accept + any other operations on the calendar and it should just be + destroyed. + + diff --git a/doc/devel/calendar/cal-util/evolution-cal-util-decl.txt b/doc/devel/calendar/cal-util/evolution-cal-util-decl.txt index 114129515b..9439f57fac 100644 --- a/doc/devel/calendar/cal-util/evolution-cal-util-decl.txt +++ b/doc/devel/calendar/cal-util/evolution-cal-util-decl.txt @@ -1,3 +1,128 @@ + +CalRecurInstanceFn +gboolean +CalComponent *comp, + time_t instance_start, + time_t instance_end, + gpointer data + + +cal_recur_generate_instances +void +CalComponent *comp,time_t start,time_t end,CalRecurInstanceFn cb,gpointer cb_data + + +CalObjInstance +typedef struct { + char *uid; /* UID of the object */ + time_t start; /* Start time of instance */ + time_t end; /* End time of instance */ +} CalObjInstance; + + +cal_obj_instance_list_free +void +GList *list + + +CalObjType +typedef enum { + CALOBJ_TYPE_EVENT = 1 << 0, + CALOBJ_TYPE_TODO = 1 << 1, + CALOBJ_TYPE_JOURNAL = 1 << 2, + CALOBJ_TYPE_ANY = 0x07 +} CalObjType; + + +cal_obj_uid_list_free +void +GList *list + + +isodate_from_time_t +char * +time_t t + + +time_add_minutes +time_t +time_t time, int minutes + + +time_add_day +time_t +time_t time, int days + + +time_add_week +time_t +time_t time, int weeks + + +time_add_month +time_t +time_t time, int months + + +time_add_year +time_t +time_t time, int years + + +time_days_in_month +int +int year, int month + + +time_from_day +time_t +int year, int month, int day + + +time_year_begin +time_t +time_t t + + +time_year_end +time_t +time_t t + + +time_month_begin +time_t +time_t t + + +time_month_end +time_t +time_t t + + +time_week_begin +time_t +time_t t + + +time_week_end +time_t +time_t t + + +time_day_begin +time_t +time_t t + + +time_day_end +time_t +time_t t + + +print_time_t +void +time_t t + CAL_COMPONENT_TYPE #define CAL_COMPONENT_TYPE (cal_component_get_type ()) @@ -594,6 +719,16 @@ typedef struct { CalComponent *comp +cal_component_add_alarm +void +CalComponent *comp, CalComponentAlarm *alarm + + +cal_component_remove_alarm +void +CalComponent *comp, const char *auid + + cal_component_get_alarm_uids GList * CalComponent *comp @@ -604,16 +739,16 @@ CalComponent *comp CalComponent *comp, const char *auid -cal_component_alarm_free -void -CalComponentAlarm *alarm - - cal_component_alarms_free void CalComponentAlarms *alarms +cal_component_alarm_new +CalComponentAlarm * +void + + cal_component_alarm_get_uid const char * CalComponentAlarm *alarm @@ -638,128 +773,8 @@ CalComponentAlarm *alarm, CalAlarmTrigger *trigger void CalComponentAlarm *alarm, CalAlarmTrigger trigger - -CalRecurInstanceFn -gboolean -CalComponent *comp, - time_t instance_start, - time_t instance_end, - gpointer data - - -cal_recur_generate_instances -void -CalComponent *comp,time_t start,time_t end,CalRecurInstanceFn cb,gpointer cb_data - - -CalObjInstance -typedef struct { - char *uid; /* UID of the object */ - time_t start; /* Start time of instance */ - time_t end; /* End time of instance */ -} CalObjInstance; - - -cal_obj_instance_list_free -void -GList *list - - -CalObjType -typedef enum { - CALOBJ_TYPE_EVENT = 1 << 0, - CALOBJ_TYPE_TODO = 1 << 1, - CALOBJ_TYPE_JOURNAL = 1 << 2, - CALOBJ_TYPE_ANY = 0x07 -} CalObjType; - - -cal_obj_uid_list_free -void -GList *list - - -isodate_from_time_t -char * -time_t t - - -time_add_minutes -time_t -time_t time, int minutes - - -time_add_day -time_t -time_t time, int days - - -time_add_week -time_t -time_t time, int weeks - - -time_add_month -time_t -time_t time, int months - - -time_add_year -time_t -time_t time, int years - - -time_days_in_month -int -int year, int month - - -time_from_day -time_t -int year, int month, int day - - -time_year_begin -time_t -time_t t - - -time_year_end -time_t -time_t t - - -time_month_begin -time_t -time_t t - - -time_month_end -time_t -time_t t - -time_week_begin -time_t -time_t t - - -time_week_end -time_t -time_t t - - -time_day_begin -time_t -time_t t - - -time_day_end -time_t -time_t t - - -print_time_t +cal_component_alarm_free void -time_t t +CalComponentAlarm *alarm diff --git a/doc/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml b/doc/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml index ff68fae99d..93625da7df 100644 --- a/doc/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml +++ b/doc/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml @@ -1,44 +1,38 @@ - - - - - -@CAL_COMPONENT_ALARM_TRIGGER_RELATED_START: -@CAL_COMPONENT_ALARM_TRIGGER_RELATED_END: - - + -@r: +@CAL_COMPONENT_ALARM_NONE: +@CAL_COMPONENT_ALARM_AUDIO: +@CAL_COMPONENT_ALARM_DISPLAY: +@CAL_COMPONENT_ALARM_EMAIL: +@CAL_COMPONENT_ALARM_PROCEDURE: +@CAL_COMPONENT_ALARM_UNKNOWN: - + -@CAL_RECUR_YEARLY: -@CAL_RECUR_MONTHLY: -@CAL_RECUR_WEEKLY: -@CAL_RECUR_DAILY: -@CAL_RECUR_HOURLY: -@CAL_RECUR_MINUTELY: -@CAL_RECUR_SECONDLY: +@str: +@Returns: - + +@comp: +@pilot_status: - + -@comp: -@pilot_id: +@ir: +@Returns: @@ -48,28 +42,29 @@ @t: @Returns: - + -@trigger: +@start: +@duration: +@Returns: - + -@t: -@hour: -@Returns: +@CAL_RECUR_YEARLY: +@CAL_RECUR_MONTHLY: +@CAL_RECUR_WEEKLY: +@CAL_RECUR_DAILY: +@CAL_RECUR_HOURLY: +@CAL_RECUR_MINUTELY: +@CAL_RECUR_SECONDLY: - + @@ -77,113 +72,108 @@ End: @str: @Returns: - + @comp: -@pilot_status: +@pilot_id: - + -@year: -@month: -@day: -@hour: -@minute: -@second: +@CAL_COMPONENT_ALARM_TRIGGER_RELATED_START: +@CAL_COMPONENT_ALARM_TRIGGER_RELATED_END: - + +@str: +@Returns: - + -@CAL_COMPONENT_ALARM_TRIGGER_RELATIVE: -@CAL_COMPONENT_ALARM_TRIGGER_ABSOLUTE: +@r: - + -@ir: +@itt: @Returns: - + -@list: +@t: +@hour: +@Returns: - + -@str: +@comp: @Returns: - + -@comp: -@Returns: - + +@secs: +@Returns: - + -@comp: -@Returns: +@trigger: - + -@itt: -@Returns: - + -@CAL_COMPONENT_ALARM_NONE: -@CAL_COMPONENT_ALARM_AUDIO: -@CAL_COMPONENT_ALARM_DISPLAY: -@CAL_COMPONENT_ALARM_EMAIL: -@CAL_COMPONENT_ALARM_PROCEDURE: -@CAL_COMPONENT_ALARM_UNKNOWN: +@list: - + -@start: -@duration: -@Returns: +@comp: +@pilot_status: @@ -193,13 +183,17 @@ End: @comp: @pilot_id: - + -@secs: -@Returns: +@year: +@month: +@day: +@hour: +@minute: +@second: @@ -210,19 +204,25 @@ End: @use_am_pm: @Returns: - + @comp: -@pilot_status: +@Returns: - + + + + + +@CAL_COMPONENT_ALARM_TRIGGER_RELATIVE: +@CAL_COMPONENT_ALARM_TRIGGER_ABSOLUTE: + + -@str: -@Returns: diff --git a/help/devel/calendar/cal-client/tmpl/evolution-cal-client-unused.sgml b/help/devel/calendar/cal-client/tmpl/evolution-cal-client-unused.sgml index 56bcf3aff5..f8f1f1408e 100644 --- a/help/devel/calendar/cal-client/tmpl/evolution-cal-client-unused.sgml +++ b/help/devel/calendar/cal-client/tmpl/evolution-cal-client-unused.sgml @@ -1,14 +1,13 @@ - + @client: -@uid: -@pilot_id: -@pilot_status: +@str_uri: +@Returns: - + @@ -17,19 +16,6 @@ @str_uri: @Returns: - - - These values describe the status of a calendar load or create - request. After asking a calendar factory to load or create a - calendar, the provided listener will get notification about the - result in asynchronous fashion. Such notification is represented - by one of these enumeration values. For values other than - #CAL_CLIENT_LOAD_SUCCESS, the #CalClient object will not accept - any other operations on the calendar and it should just be - destroyed. - - - @@ -63,14 +49,28 @@ @client: @Returns: - + @client: -@str_uri: -@Returns: +@uid: +@pilot_id: +@pilot_status: + + + + These values describe the status of a calendar load or create + request. After asking a calendar factory to load or create a + calendar, the provided listener will get notification about the + result in asynchronous fashion. Such notification is represented + by one of these enumeration values. For values other than + #CAL_CLIENT_LOAD_SUCCESS, the #CalClient object will not accept + any other operations on the calendar and it should just be + destroyed. + + diff --git a/help/devel/calendar/cal-util/evolution-cal-util-decl.txt b/help/devel/calendar/cal-util/evolution-cal-util-decl.txt index 114129515b..9439f57fac 100644 --- a/help/devel/calendar/cal-util/evolution-cal-util-decl.txt +++ b/help/devel/calendar/cal-util/evolution-cal-util-decl.txt @@ -1,3 +1,128 @@ + +CalRecurInstanceFn +gboolean +CalComponent *comp, + time_t instance_start, + time_t instance_end, + gpointer data + + +cal_recur_generate_instances +void +CalComponent *comp,time_t start,time_t end,CalRecurInstanceFn cb,gpointer cb_data + + +CalObjInstance +typedef struct { + char *uid; /* UID of the object */ + time_t start; /* Start time of instance */ + time_t end; /* End time of instance */ +} CalObjInstance; + + +cal_obj_instance_list_free +void +GList *list + + +CalObjType +typedef enum { + CALOBJ_TYPE_EVENT = 1 << 0, + CALOBJ_TYPE_TODO = 1 << 1, + CALOBJ_TYPE_JOURNAL = 1 << 2, + CALOBJ_TYPE_ANY = 0x07 +} CalObjType; + + +cal_obj_uid_list_free +void +GList *list + + +isodate_from_time_t +char * +time_t t + + +time_add_minutes +time_t +time_t time, int minutes + + +time_add_day +time_t +time_t time, int days + + +time_add_week +time_t +time_t time, int weeks + + +time_add_month +time_t +time_t time, int months + + +time_add_year +time_t +time_t time, int years + + +time_days_in_month +int +int year, int month + + +time_from_day +time_t +int year, int month, int day + + +time_year_begin +time_t +time_t t + + +time_year_end +time_t +time_t t + + +time_month_begin +time_t +time_t t + + +time_month_end +time_t +time_t t + + +time_week_begin +time_t +time_t t + + +time_week_end +time_t +time_t t + + +time_day_begin +time_t +time_t t + + +time_day_end +time_t +time_t t + + +print_time_t +void +time_t t + CAL_COMPONENT_TYPE #define CAL_COMPONENT_TYPE (cal_component_get_type ()) @@ -594,6 +719,16 @@ typedef struct { CalComponent *comp +cal_component_add_alarm +void +CalComponent *comp, CalComponentAlarm *alarm + + +cal_component_remove_alarm +void +CalComponent *comp, const char *auid + + cal_component_get_alarm_uids GList * CalComponent *comp @@ -604,16 +739,16 @@ CalComponent *comp CalComponent *comp, const char *auid -cal_component_alarm_free -void -CalComponentAlarm *alarm - - cal_component_alarms_free void CalComponentAlarms *alarms +cal_component_alarm_new +CalComponentAlarm * +void + + cal_component_alarm_get_uid const char * CalComponentAlarm *alarm @@ -638,128 +773,8 @@ CalComponentAlarm *alarm, CalAlarmTrigger *trigger void CalComponentAlarm *alarm, CalAlarmTrigger trigger - -CalRecurInstanceFn -gboolean -CalComponent *comp, - time_t instance_start, - time_t instance_end, - gpointer data - - -cal_recur_generate_instances -void -CalComponent *comp,time_t start,time_t end,CalRecurInstanceFn cb,gpointer cb_data - - -CalObjInstance -typedef struct { - char *uid; /* UID of the object */ - time_t start; /* Start time of instance */ - time_t end; /* End time of instance */ -} CalObjInstance; - - -cal_obj_instance_list_free -void -GList *list - - -CalObjType -typedef enum { - CALOBJ_TYPE_EVENT = 1 << 0, - CALOBJ_TYPE_TODO = 1 << 1, - CALOBJ_TYPE_JOURNAL = 1 << 2, - CALOBJ_TYPE_ANY = 0x07 -} CalObjType; - - -cal_obj_uid_list_free -void -GList *list - - -isodate_from_time_t -char * -time_t t - - -time_add_minutes -time_t -time_t time, int minutes - - -time_add_day -time_t -time_t time, int days - - -time_add_week -time_t -time_t time, int weeks - - -time_add_month -time_t -time_t time, int months - - -time_add_year -time_t -time_t time, int years - - -time_days_in_month -int -int year, int month - - -time_from_day -time_t -int year, int month, int day - - -time_year_begin -time_t -time_t t - - -time_year_end -time_t -time_t t - - -time_month_begin -time_t -time_t t - - -time_month_end -time_t -time_t t - -time_week_begin -time_t -time_t t - - -time_week_end -time_t -time_t t - - -time_day_begin -time_t -time_t t - - -time_day_end -time_t -time_t t - - -print_time_t +cal_component_alarm_free void -time_t t +CalComponentAlarm *alarm diff --git a/help/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml b/help/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml index ff68fae99d..93625da7df 100644 --- a/help/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml +++ b/help/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml @@ -1,44 +1,38 @@ - - - - - -@CAL_COMPONENT_ALARM_TRIGGER_RELATED_START: -@CAL_COMPONENT_ALARM_TRIGGER_RELATED_END: - - + -@r: +@CAL_COMPONENT_ALARM_NONE: +@CAL_COMPONENT_ALARM_AUDIO: +@CAL_COMPONENT_ALARM_DISPLAY: +@CAL_COMPONENT_ALARM_EMAIL: +@CAL_COMPONENT_ALARM_PROCEDURE: +@CAL_COMPONENT_ALARM_UNKNOWN: - + -@CAL_RECUR_YEARLY: -@CAL_RECUR_MONTHLY: -@CAL_RECUR_WEEKLY: -@CAL_RECUR_DAILY: -@CAL_RECUR_HOURLY: -@CAL_RECUR_MINUTELY: -@CAL_RECUR_SECONDLY: +@str: +@Returns: - + +@comp: +@pilot_status: - + -@comp: -@pilot_id: +@ir: +@Returns: @@ -48,28 +42,29 @@ @t: @Returns: - + -@trigger: +@start: +@duration: +@Returns: - + -@t: -@hour: -@Returns: +@CAL_RECUR_YEARLY: +@CAL_RECUR_MONTHLY: +@CAL_RECUR_WEEKLY: +@CAL_RECUR_DAILY: +@CAL_RECUR_HOURLY: +@CAL_RECUR_MINUTELY: +@CAL_RECUR_SECONDLY: - + @@ -77,113 +72,108 @@ End: @str: @Returns: - + @comp: -@pilot_status: +@pilot_id: - + -@year: -@month: -@day: -@hour: -@minute: -@second: +@CAL_COMPONENT_ALARM_TRIGGER_RELATED_START: +@CAL_COMPONENT_ALARM_TRIGGER_RELATED_END: - + +@str: +@Returns: - + -@CAL_COMPONENT_ALARM_TRIGGER_RELATIVE: -@CAL_COMPONENT_ALARM_TRIGGER_ABSOLUTE: +@r: - + -@ir: +@itt: @Returns: - + -@list: +@t: +@hour: +@Returns: - + -@str: +@comp: @Returns: - + -@comp: -@Returns: - + +@secs: +@Returns: - + -@comp: -@Returns: +@trigger: - + -@itt: -@Returns: - + -@CAL_COMPONENT_ALARM_NONE: -@CAL_COMPONENT_ALARM_AUDIO: -@CAL_COMPONENT_ALARM_DISPLAY: -@CAL_COMPONENT_ALARM_EMAIL: -@CAL_COMPONENT_ALARM_PROCEDURE: -@CAL_COMPONENT_ALARM_UNKNOWN: +@list: - + -@start: -@duration: -@Returns: +@comp: +@pilot_status: @@ -193,13 +183,17 @@ End: @comp: @pilot_id: - + -@secs: -@Returns: +@year: +@month: +@day: +@hour: +@minute: +@second: @@ -210,19 +204,25 @@ End: @use_am_pm: @Returns: - + @comp: -@pilot_status: +@Returns: - + + + + + +@CAL_COMPONENT_ALARM_TRIGGER_RELATIVE: +@CAL_COMPONENT_ALARM_TRIGGER_ABSOLUTE: + + -@str: -@Returns: -- cgit v1.2.3