* use strbuffer as wprintf backend
[citadel.git] / webcit / availability.c
index 009bf9f70f3e616a3c36171cd5ca97960de83196..097725523433ff9be9d7a1fa32158622f5af408c 100644 (file)
@@ -1,39 +1,33 @@
 /*
  * $Id$
  *
- * Check attendee availability for scheduling a meeting.
- *
  */
 
+
 #include "webcit.h"
 #include "webserver.h"
 
-
-#ifdef WEBCIT_WITH_CALENDAR_SERVICE
-
-
-
 /*
- * Utility function to fetch a VFREEBUSY type of thing for
- * any specified user.
+ * Utility function to fetch a VFREEBUSY type of thing for any specified user.
  */
 icalcomponent *get_freebusy_for_user(char *who) {
+       long nLines;
        char buf[SIZ];
-       char *serialized_fb = NULL;
+       StrBuf *serialized_fb = NULL;
        icalcomponent *fb = NULL;
 
        serv_printf("ICAL freebusy|%s", who);
        serv_getln(buf, sizeof buf);
        if (buf[0] == '1') {
-               serialized_fb = read_server_text();
+               serialized_fb = read_server_text(&nLines);
        }
 
        if (serialized_fb == NULL) {
                return NULL;
        }
        
-       fb = icalcomponent_new_from_string(serialized_fb);
-       free(serialized_fb);
+       fb = icalcomponent_new_from_string(ChrPtr(serialized_fb));
+       FreeStrBuf(&serialized_fb);
        if (fb == NULL) {
                return NULL;
        }
@@ -42,12 +36,13 @@ icalcomponent *get_freebusy_for_user(char *who) {
 }
 
 
-
-
 /*
- * Check to see if two events overlap.  Returns nonzero if they do.
+ * Check to see if two events overlap.  
  * (This function is used in both Citadel and WebCit.  If you change it in
- * one place, change it in the other.  Better yet, put it in a library.)
+ * one place, change it in the other.  We should seriously consider moving
+ * this function upstream into libical.)
+ *
+ * Returns nonzero if they do overlap.
  */
 int ical_ctdl_is_overlap(
                        struct icaltimetype t1start,
@@ -82,6 +77,11 @@ int ical_ctdl_is_overlap(
                }
        }
 
+       /* lprintf (9, "Comparing t1start %d:%d t1end %d:%d t2start %d:%d t2end %d:%d \n",
+               t1start.hour, t1start.minute, t1end.hour, t1end.minute,
+               t2start.hour, t2start.minute, t2end.hour, t2end.minute);
+       */
+
        /* Now check for overlaps using date *and* time. */
 
        /* First, bail out if either event 1 or event 2 is missing end time. */
@@ -90,9 +90,11 @@ int ical_ctdl_is_overlap(
 
        /* If event 1 ends before event 2 starts, we're in the clear. */
        if (icaltime_compare(t1end, t2start) <= 0) return(0);
+       // lprintf(9, "first passed\n");
 
        /* If event 2 ends before event 1 starts, we're also ok. */
        if (icaltime_compare(t2end, t1start) <= 0) return(0);
+       // lprintf(9, "second passed\n");
 
        /* Otherwise, they overlap. */
        return(1);
@@ -101,10 +103,15 @@ int ical_ctdl_is_overlap(
 
 
 /*
+ * \brief dig availability on citserver
  * Back end function for check_attendee_availability()
  * This one checks an individual attendee against a supplied
  * event start and end time.  All these fields have already been
- * broken out.  The result is placed in 'annotation'.
+ * broken out.  
+ * \param attendee_string name of the attendee
+ * \param event_start starttime of the event to check
+ * \param event_end endtime of the event to check
+ * \return The result is placed in 'annotation'.
  */
 void check_individual_attendee(char *attendee_string,
                                struct icaltimetype event_start,
@@ -116,17 +123,19 @@ void check_individual_attendee(char *attendee_string,
        icalproperty *thisfb = NULL;
        struct icalperiodtype period;
 
-       /* Set to 'unknown' right from the beginning.  Unless we learn
+       /**
+        * Set to 'unknown' right from the beginning.  Unless we learn
         * something else, that's what we'll go with.
         */
-       strcpy(annotation, "availability unknown");
+       strcpy(annotation, _("availability unknown"));
 
        fbc = get_freebusy_for_user(attendee_string);
        if (fbc == NULL) {
                return;
        }
 
-       /* Make sure we're looking at a VFREEBUSY by itself.  What we're probably
+       /**
+        * Make sure we're looking at a VFREEBUSY by itself.  What we're probably
         * looking at initially is a VFREEBUSY encapsulated in a VCALENDAR.
         */
        if (icalcomponent_isa(fbc) == ICAL_VCALENDAR_COMPONENT) {
@@ -136,20 +145,20 @@ void check_individual_attendee(char *attendee_string,
                fb = fbc;
        }
 
-       /* Iterate through all FREEBUSY's looking for conflicts. */
+       /** Iterate through all FREEBUSY's looking for conflicts. */
        if (fb != NULL) {
 
-               strcpy(annotation, "free");
+               strcpy(annotation, _("free"));
 
                for (thisfb = icalcomponent_get_first_property(fb, ICAL_FREEBUSY_PROPERTY);
                    thisfb != NULL;
                    thisfb = icalcomponent_get_next_property(fb, ICAL_FREEBUSY_PROPERTY) ) {
 
-                       /* Do the check */
+                       /** Do the check */
                        period = icalproperty_get_freebusy(thisfb);
                        if (ical_ctdl_is_overlap(period.start, period.end,
                           event_start, event_end)) {
-                               strcpy(annotation, "BUSY");
+                               strcpy(annotation, _("BUSY"));
                        }
 
                }
@@ -161,9 +170,11 @@ void check_individual_attendee(char *attendee_string,
 
 
 
-/*
+/**
+ * \brief check attendees availability
  * Check the availability of all attendees for an event (when possible)
  * and annotate accordingly.
+ * \param vevent the event which should be compared with attendees calendar
  */
 void check_attendee_availability(icalcomponent *vevent) {
        icalproperty *attendee = NULL;
@@ -179,7 +190,8 @@ void check_attendee_availability(icalcomponent *vevent) {
                return;
        }
 
-       /* If we're looking at a fully encapsulated VCALENDAR
+       /**
+        * If we're looking at a fully encapsulated VCALENDAR
         * rather than a VEVENT component, attempt to use the first
         * relevant VEVENT subcomponent.  If there is none, the
         * NULL returned by icalcomponent_get_first_component() will
@@ -195,9 +207,9 @@ void check_attendee_availability(icalcomponent *vevent) {
                return;
        }
 
-       ical_dezonify(vevent);          /* Convert everything to UTC */
+       ical_dezonify(vevent);          /**< Convert everything to UTC */
 
-       /*
+       /**
         * Learn the start and end times.
         */
        dtstart_p = icalcomponent_get_first_property(vevent, ICAL_DTSTART_PROPERTY);
@@ -206,7 +218,7 @@ void check_attendee_availability(icalcomponent *vevent) {
        dtend_p = icalcomponent_get_first_property(vevent, ICAL_DTEND_PROPERTY);
        if (dtend_p != NULL) dtend_t = icalproperty_get_dtend(dtend_p);
 
-       /*
+       /**
         * Iterate through attendees.
         */
        for (attendee = icalcomponent_get_first_property(vevent, ICAL_ATTENDEE_PROPERTY);
@@ -216,7 +228,7 @@ void check_attendee_availability(icalcomponent *vevent) {
                strcpy(attendee_string, icalproperty_get_attendee(attendee));
                if (!strncasecmp(attendee_string, "MAILTO:", 7)) {
 
-                       /* screen name or email address */
+                       /** screen name or email address */
                        strcpy(attendee_string, &attendee_string[7]);
                        striplt(attendee_string);
 
@@ -224,7 +236,7 @@ void check_attendee_availability(icalcomponent *vevent) {
                                                dtstart_t, dtend_t,
                                                annotation);
 
-                       /* Replace the attendee name with an annotated one. */
+                       /** Replace the attendee name with an annotated one. */
                        snprintf(annotated_attendee_string, sizeof annotated_attendee_string,
                                "MAILTO:%s (%s)", attendee_string, annotation);
                        icalproperty_set_attendee(attendee, annotated_attendee_string);
@@ -234,5 +246,3 @@ void check_attendee_availability(icalcomponent *vevent) {
 
 }
 
-
-#endif /* WEBCIT_WITH_CALENDAR_SERVICE */