Re: [Evolution-hackers] What's the function of RECURRENCE ID

[Jules Colding <colding omesc com>]

On Tue, 2006-11-14 at 11:59 +0100, YANG Lin RD-ILAB-PEK wrote:
>  Hi,
>  
> The rfc2445 has the definition of RECURRENCE-ID, and the libical
> provides the interface:
> "icalcomponent_get_recurrenceid ( )".  The rid can be used in the
> function 
> "e_cal_get_object ( )" to specify the rid of the icalcomponent. But the
> libical doesn't provide
> example of the usage of RECURRENCE-ID. I'm puzzled by the functions of
> RECURRENCE-ID.
> Rfc2445 has provided the recurrence component properties like recurrence
> rule, recurrence date/time,
> Exception rule...
> These are enough to describe a repeating component.
> Can anybody give me a use case that the RECURRENCE-ID must be used?

Such as when removing a single instance:

ECalBackendSyncStatus (*remove_object_sync) (ECalBackendSync *backend, 
                                             EDataCal *cal, 
                                             const char *uid, 
                                             const char *rid, // <== RECURRENCE-ID
                                             CalObjModType mod, 
                                             char **old_object, 
                                             char **object);


HTH,
  jules