Began making changes to do better handling of character sets.
[citadel.git] / webcit / calendar.c
index a52c9a0573358e1b38080f1ed547154c962cd354..5353dfa67d8f11f7cc9502ff53b0239de196cdb5 100644 (file)
@@ -1,64 +1,59 @@
 /*
  * $Id$
- *
- * Functions which handle calendar objects and their processing/display.
- *
  */
+/**
+ * \defgroup calav Functions which handle calendar objects and their processing/display.
+ * \ingroup Calendaring
+ */
+/* @{ */
 
-#include <ctype.h>
-#include <stdlib.h>
-#include <unistd.h>
-#include <stdio.h>
-#include <fcntl.h>
-#include <signal.h>
-#include <sys/types.h>
-#include <sys/wait.h>
-#include <sys/socket.h>
-#include <limits.h>
-#include <netinet/in.h>
-#include <netdb.h>
-#include <string.h>
-#include <pwd.h>
-#include <errno.h>
-#include <stdarg.h>
-#include <pthread.h>
-#include <signal.h>
-#include <time.h>
 #include "webcit.h"
 #include "webserver.h"
 
 #ifndef WEBCIT_WITH_CALENDAR_SERVICE
 
-/*
+/**
+ * \brief get around non existing types
  * Handler stubs for builds with no calendar library available
+ * \param part_source dummy pointer to the source
+ * \param msgnum number of the mesage in the db
+ * \param cal_partnum number of the calendar part
  */
 void cal_process_attachment(char *part_source, long msgnum, char *cal_partnum) {
 
-       wprintf("<I>This message contains calendaring/scheduling information,"
+       wprintf(_("<I>This message contains calendaring/scheduling information,"
                " but support for calendars is not available on this "
                "particular system.  Please ask your system administrator to "
                "install a new version of the Citadel web service with "
-               "calendaring enabled.</I><BR>\n"
+               "calendaring enabled.</I><br />\n")
        );
 
 }
 
+/**
+ * \brief say we can't display calendar items
+ * \param msgnum number of the mesage in our db
+ */
 void display_calendar(long msgnum) {
-       wprintf("<i>"
+       wprintf(_("<i>"
                "Cannot display calendar item.  You are seeing this error "
                "because your WebCit service has not been installed with "
                "calendar support.  Please contact your system administrator."
-               "</i><br>\n");
+               "</i><br />\n"));
 }
 
+/**
+ * \brief say we can't display task items
+ * \param msgnum number of the mesage in our db
+ */
 void display_task(long msgnum) {
-       wprintf("<i>"
+       wprintf(_("<i>"
                "Cannot display to-do item.  You are seeing this error "
                "because your WebCit service has not been installed with "
                "calendar support.  Please contact your system administrator."
-               "</i><br>\n");
+               "</i><br />\n"));
 }
-
+/** ok, we have calendaring available */
 #else /* WEBCIT_WITH_CALENDAR_SERVICE */
 
 
@@ -67,12 +62,13 @@ void display_task(long msgnum) {
 
 
 
-/*
- * Process a calendar object
+/**
+ * \brief Process a calendar object
  * ...at this point it's already been deserialized by cal_process_attachment()
- *
- * ok for complete vcalendar objects
- *
+ * \param cal teh calendar object
+ * \param recursion_level call stack depth ??????
+ * \param msgnum number of the mesage in our db
+ * \param cal_partnum of the calendar object ???? 
  */
 void cal_process_object(icalcomponent *cal,
                        int recursion_level,
@@ -85,72 +81,77 @@ void cal_process_object(icalcomponent *cal,
        icalproperty *p;
        struct icaltimetype t;
        time_t tt;
-       char buf[SIZ];
-       char conflict_name[SIZ];
+       char buf[256];
+       char conflict_name[256];
+       char conflict_message[256];
        int is_update = 0;
 
-       /* Leading HTML for the display of this object */
+       /** Leading HTML for the display of this object */
        if (recursion_level == 0) {
                wprintf("<CENTER><TABLE border=0>\n");
        }
 
-       /* Look for a method */
+       /** Look for a method */
        method = icalcomponent_get_first_property(cal, ICAL_METHOD_PROPERTY);
 
-       /* See what we need to do with this */
+       /** See what we need to do with this */
        if (method != NULL) {
                the_method = icalproperty_get_method(method);
                switch(the_method) {
                    case ICAL_METHOD_REQUEST:
-                       wprintf("<TR><TD COLSPAN=2>\n"
-                               "<IMG ALIGN=CENTER "
-                               "SRC=\"/static/vcalendar.gif\">"
+                       wprintf("<tr><td colspan=\"2\">\n"
+                               "<img align=\"center\" "
+                               "src=\"static/calarea_48x.gif\">"
                                "&nbsp;&nbsp;"  
-                               "<B>Meeting invitation</B>
-                               </TD></TR>\n"
-                       );
+                               "<B>");
+                       wprintf(_("Meeting invitation"));
+                       wprintf("</B></TD></TR>\n");
                        break;
                    case ICAL_METHOD_REPLY:
                        wprintf("<TR><TD COLSPAN=2>\n"
                                "<IMG ALIGN=CENTER "
-                               "SRC=\"/static/vcalendar.gif\">"
+                               "src=\"static/calarea_48x.gif\">"
                                "&nbsp;&nbsp;"  
-                               "<B>Attendee's reply to your invitation</B>
-                               </TD></TR>\n"
-                       );
+                               "<B>");
+                       wprintf(_("Attendee's reply to your invitation"));
+                       wprintf("</B></TD></TR>\n");
                        break;
                    case ICAL_METHOD_PUBLISH:
                        wprintf("<TR><TD COLSPAN=2>\n"
                                "<IMG ALIGN=CENTER "
-                               "SRC=\"/static/vcalendar.gif\">"
+                               "src=\"static/calarea_48x.gif\">"
                                "&nbsp;&nbsp;"  
-                               "<B>Published event</B>
-                               </TD></TR>\n"
-                       );
+                               "<B>");
+                       wprintf(_("Published event"));
+                       wprintf("</B></TD></TR>\n");
                        break;
                    default:
-                       wprintf("<TR><TD COLSPAN=2>"
-                               "I don't know what to do with this.</TD></TR>"
-                               "\n");
+                       wprintf("<TR><TD COLSPAN=2>");
+                       wprintf(_("This is an unknown type of calendar item."));
+                       wprintf("</TD></TR>\n");
                        break;
                }
        }
 
        p = icalcomponent_get_first_property(cal, ICAL_SUMMARY_PROPERTY);
        if (p != NULL) {
-               wprintf("<TR><TD><B>Summary:</B></TD><TD>");
+               wprintf("<TR><TD><B>");
+               wprintf(_("Summary:"));
+               wprintf("</B></TD><TD>");
                escputs((char *)icalproperty_get_comment(p));
                wprintf("</TD></TR>\n");
        }
 
        p = icalcomponent_get_first_property(cal, ICAL_LOCATION_PROPERTY);
        if (p != NULL) {
-               wprintf("<TR><TD><B>Location:</B></TD><TD>");
+               wprintf("<TR><TD><B>");
+               wprintf(_("Location:"));
+               wprintf("</B></TD><TD>");
                escputs((char *)icalproperty_get_comment(p));
                wprintf("</TD></TR>\n");
        }
 
-       /*
+       /**
         * Only show start/end times if we're actually looking at the VEVENT
         * component.  Otherwise it shows bogus dates for things like timezone.
         */
@@ -162,20 +163,23 @@ void cal_process_object(icalcomponent *cal,
                        t = icalproperty_get_dtstart(p);
 
                        if (t.is_date) {
-                               wprintf("<TR><TD><B>Date:"
-                                       "</B></TD><TD>"
-                                       "%s %d, %d</TD></TR>",
-                                       months[t.month - 1],
-                                       t.day, t.year
-                               );
+                               struct tm d_tm;
+                               char d_str[32];
+                               memset(&d_tm, 0, sizeof d_tm);
+                               d_tm.tm_year = t.year - 1900;
+                               d_tm.tm_mon = t.month - 1;
+                               d_tm.tm_mday = t.day;
+                               wc_strftime(d_str, sizeof d_str, "%x", &d_tm);
+                               wprintf("<TR><TD><B>");
+                               wprintf(_("Date:"));
+                               wprintf("</B></TD><TD>%s</TD></TR>", d_str);
                        }
                        else {
                                tt = icaltime_as_timet(t);
-                               fmt_date(buf, tt);
-                               wprintf("<TR><TD><B>Starting date/time:"
-                                       "</B></TD><TD>"
-                                       "%s</TD></TR>", buf
-                               );
+                               fmt_date(buf, tt, 0);
+                               wprintf("<TR><TD><B>");
+                               wprintf(_("Starting date/time:"));
+                               wprintf("</B></TD><TD>%s</TD></TR>", buf);
                        }
                }
        
@@ -183,41 +187,45 @@ void cal_process_object(icalcomponent *cal,
                if (p != NULL) {
                        t = icalproperty_get_dtend(p);
                        tt = icaltime_as_timet(t);
-                       fmt_date(buf, tt);
-                       wprintf("<TR><TD><B>Ending date/time:</B></TD><TD>"
-                               "%s</TD></TR>", buf
-                       );
+                       fmt_date(buf, tt, 0);
+                       wprintf("<TR><TD><B>");
+                       wprintf(_("Ending date/time:"));
+                       wprintf("</B></TD><TD>%s</TD></TR>", buf);
                }
 
        }
 
        p = icalcomponent_get_first_property(cal, ICAL_DESCRIPTION_PROPERTY);
        if (p != NULL) {
-               wprintf("<TR><TD><B>Description:</B></TD><TD>");
+               wprintf("<TR><TD><B>");
+               wprintf(_("Description:"));
+               wprintf("</B></TD><TD>");
                escputs((char *)icalproperty_get_comment(p));
                wprintf("</TD></TR>\n");
        }
 
-       /* If the component has attendees, iterate through them. */
+       /** If the component has attendees, iterate through them. */
        for (p = icalcomponent_get_first_property(cal, ICAL_ATTENDEE_PROPERTY); (p != NULL); p = icalcomponent_get_next_property(cal, ICAL_ATTENDEE_PROPERTY)) {
-               wprintf("<TR><TD><B>Attendee:</B></TD><TD>");
-               strcpy(buf, icalproperty_get_attendee(p));
+               wprintf("<TR><TD><B>");
+               wprintf(_("Attendee:"));
+               wprintf("</B></TD><TD>");
+               safestrncpy(buf, icalproperty_get_attendee(p), sizeof buf);
                if (!strncasecmp(buf, "MAILTO:", 7)) {
 
-                       /* screen name or email address */
+                       /** screen name or email address */
                        strcpy(buf, &buf[7]);
                        striplt(buf);
                        escputs(buf);
                        wprintf(" ");
 
-                       /* participant status */
+                       /** participant status */
                        partstat_as_string(buf, p);
                        escputs(buf);
                }
                wprintf("</TD></TR>\n");
        }
 
-       /* If the component has subcomponents, recurse through them. */
+       /** If the component has subcomponents, recurse through them. */
        for (c = icalcomponent_get_first_component(cal, ICAL_ANY_COMPONENT);
            (c != 0);
            c = icalcomponent_get_next_component(cal, ICAL_ANY_COMPONENT)) {
@@ -225,98 +233,83 @@ void cal_process_object(icalcomponent *cal,
                cal_process_object(c, recursion_level+1, msgnum, cal_partnum);
        }
 
-       /* If this is a REQUEST, display conflicts and buttons */
+       /** If this is a REQUEST, display conflicts and buttons */
        if (the_method == ICAL_METHOD_REQUEST) {
 
                /* Check for conflicts */
                lprintf(9, "Checking server calendar for conflicts...\n");
                serv_printf("ICAL conflicts|%ld|%s|", msgnum, cal_partnum);
-               serv_gets(buf);
+               serv_getln(buf, sizeof buf);
                if (buf[0] == '1') {
-                       while (serv_gets(buf), strcmp(buf, "000")) {
-                               extract(conflict_name, buf, 3);
+                       while (serv_getln(buf, sizeof buf), strcmp(buf, "000")) {
+                               extract_token(conflict_name, buf, 3, '|', sizeof conflict_name);
                                is_update = extract_int(buf, 4);
-                               wprintf("<TR><TD><B><I>%s</I></B></TD>"
-                                       "<TD>"
-                                       "%s "
-                                       "<I>&quot;",
 
-                                       (is_update ?
-                                               "Update:" :
-                                               "CONFLICT:"
-                                       ),
+                               if (is_update) {
+                                       snprintf(conflict_message, sizeof conflict_message,
+                                               _("This is an update of '%s' which is already in your calendar."), conflict_name);
+                               }
+                               else {
+                                       snprintf(conflict_message, sizeof conflict_message,
+                                               _("This event would conflict with '%s' which is already in your calendar."), conflict_name);
+                               }
 
+                               wprintf("<TR><TD><B><I>%s</I></B></TD><td>",
                                        (is_update ?
-                                               "This is an update of" :
-                                               "This event would conflict with"
+                                               _("Update:") :
+                                               _("CONFLICT:")
                                        )
-               
                                );
-                               escputs(conflict_name);
-                               wprintf("&quot;</I> "
-                                       "which is already in your calendar."
-                                       "</TD></TR>\n");
+                               escputs(conflict_message);
+                               wprintf("</TD></TR>\n");
                        }
                }
                lprintf(9, "...done.\n");
 
-               /* Display the Accept/Decline buttons */
-               wprintf("<TR><TD COLSPAN=2>"
-                       "<FORM METHOD=\"GET\" "
-                       "ACTION=\"/respond_to_request\">\n"
-                       "<INPUT TYPE=\"submit\" NAME=\"sc\" "
-                               "VALUE=\"Accept\">\n"
-                       "&nbsp;&nbsp;"
-                       "<INPUT TYPE=\"submit\" NAME=\"sc\" "
-                               "VALUE=\"Tentative\">\n"
-                       "&nbsp;&nbsp;"
-                       "<INPUT TYPE=\"submit\" NAME=\"sc\" "
-                               "VALUE=\"Decline\">\n"
-                       "<INPUT TYPE=\"hidden\" NAME=\"msgnum\" "
-                               "VALUE=\"%ld\">"
-                       "<INPUT TYPE=\"hidden\" NAME=\"cal_partnum\" "
-                               "VALUE=\"%s\">"
-                       "</FORM>"
-                       "</TD></TR>\n",
-                       msgnum, cal_partnum
+               /** Display the Accept/Decline buttons */
+               wprintf("<tr><td>%s</td>"
+                       "<td><font size=+1>"
+                       "<a href=\"respond_to_request?msgnum=%ld&cal_partnum=%s&sc=Accept\">%s</a>"
+                       " | "
+                       "<a href=\"respond_to_request?msgnum=%ld&cal_partnum=%s&sc=Tentative\">%s</a>"
+                       " | "
+                       "<a href=\"respond_to_request?msgnum=%ld&cal_partnum=%s&sc=Decline\">%s</a>"
+                       "</FONT></TD></TR>\n",
+                       _("How would you like to respond to this invitation?"),
+                       msgnum, cal_partnum, _("Accept"),
+                       msgnum, cal_partnum, _("Tentative"),
+                       msgnum, cal_partnum, _("Decline")
                );
 
        }
 
-       /* If this is a REPLY, display update button */
+       /** If this is a REPLY, display update button */
        if (the_method == ICAL_METHOD_REPLY) {
 
-               /***********
-                * In the future, if we want to validate this object before
+               /** \todo  In the future, if we want to validate this object before \
                 * continuing, we can do it this way:
                serv_printf("ICAL whatever|%ld|%s|", msgnum, cal_partnum);
-               serv_gets(buf);
+               serv_getln(buf, sizeof buf);
                }
                 ***********/
 
-               /* Display the update buttons */
-               wprintf("<TR><TD COLSPAN=2>"
-                       "Click <i>Update</i> to accept this reply and "
-                       "update your calendar."
-                       "<FORM METHOD=\"GET\" "
-                       "ACTION=\"/handle_rsvp\">\n"
-                       "<INPUT TYPE=\"submit\" NAME=\"sc\" "
-                               "VALUE=\"Update\">\n"
-                       "&nbsp;&nbsp;"
-                       "<INPUT TYPE=\"submit\" NAME=\"sc\" "
-                               "VALUE=\"Ignore\">\n"
-                       "<INPUT TYPE=\"hidden\" NAME=\"msgnum\" "
-                               "VALUE=\"%ld\">"
-                       "<INPUT TYPE=\"hidden\" NAME=\"cal_partnum\" "
-                               "VALUE=\"%s\">"
-                       "</FORM>"
+               /** Display the update buttons */
+               wprintf("<TR><TD>"
+                       "%s"
+                       "</td><td><font size=+1>"
+                       "<a href=\"handle_rsvp?msgnum=%ld&cal_partnum=%s&sc=Update\">%s</a>"
+                       " | "
+                       "<a href=\"handle_rsvp?msgnum=%ld&cal_partnum=%s&sc=Ignore\">%s</a>"
+                       "</font>"
                        "</TD></TR>\n",
-                       msgnum, cal_partnum
+                       _("Click <i>Update</i> to accept this reply and update your calendar."),
+                       msgnum, cal_partnum, _("Update"),
+                       msgnum, cal_partnum, _("Ignore")
                );
 
        }
 
-       /* Trailing HTML for the display of this object */
+       /** Trailing HTML for the display of this object */
        if (recursion_level == 0) {
 
                wprintf("</TR></TABLE></CENTER>\n");
@@ -324,10 +317,13 @@ void cal_process_object(icalcomponent *cal,
 }
 
 
-/*
+/**
+ * \brief process calendar mail atachment
  * Deserialize a calendar object in a message so it can be processed.
  * (This is the main entry point for these things)
- * ok for complete vcalendar objects
+ * \param part_source the part of the message we want to parse
+ * \param msgnum number of the mesage in our db
+ * \param cal_partnum the number of the calendar item
  */
 void cal_process_attachment(char *part_source, long msgnum, char *cal_partnum) {
        icalcomponent *cal;
@@ -335,7 +331,8 @@ void cal_process_attachment(char *part_source, long msgnum, char *cal_partnum) {
        cal = icalcomponent_new_from_string(part_source);
 
        if (cal == NULL) {
-               wprintf("Error parsing calendar object<BR>\n");
+               wprintf(_("There was an error parsing this calendar item."));
+               wprintf("<br />\n");
                return;
        }
 
@@ -349,73 +346,83 @@ void cal_process_attachment(char *part_source, long msgnum, char *cal_partnum) {
 
 
 
-/*
+/**
+ * \brief accept/decline meeting
  * Respond to a meeting request
  */
 void respond_to_request(void) {
        char buf[SIZ];
 
-       output_headers(3);
+       output_headers(1, 1, 2, 0, 0, 0);
 
-       wprintf("<TABLE WIDTH=100%% BORDER=0 BGCOLOR=\"#007700\"><TR><TD>"
-               "<SPAN CLASS=\"titlebar\">Respond to meeting request</SPAN>"
-               "</TD></TR></TABLE><BR>\n"
+       wprintf("<div id=\"banner\">\n");
+       wprintf("<TABLE WIDTH=100%% BORDER=0 BGCOLOR=\"#444455\"><TR><TD>"
+               "<SPAN CLASS=\"titlebar\">");
+       wprintf(_("Respond to meeting request"));
+       wprintf("</SPAN>"
+               "</TD></TR></TABLE>\n"
        );
+       wprintf("</div>\n<div id=\"content\">\n");
 
        serv_printf("ICAL respond|%s|%s|%s|",
                bstr("msgnum"),
                bstr("cal_partnum"),
                bstr("sc")
        );
-       serv_gets(buf);
+       serv_getln(buf, sizeof buf);
 
        if (buf[0] == '2') {
                wprintf("<TABLE BORDER=0><TR><TD>"
-                       "<IMG SRC=\"static/vcalendar.gif\" ALIGN=CENTER>"
+                       "<img src=\"static/calarea_48x.gif\" ALIGN=CENTER>"
                        "</TD><TD>"
                );
                if (!strcasecmp(bstr("sc"), "accept")) {
-                       wprintf("You have accepted this meeting invitation.  "
-                               "It has been entered into your calendar, "
+                       wprintf(_("You have accepted this meeting invitation.  "
+                               "It has been entered into your calendar.")
                        );
                } else if (!strcasecmp(bstr("sc"), "tentative")) {
-                       wprintf("You have tentatively accepted this meeting invitation.  "
-                               "It has been 'pencilled in' to your calendar, "
+                       wprintf(_("You have tentatively accepted this meeting invitation.  "
+                               "It has been 'pencilled in' to your calendar.")
                        );
                } else if (!strcasecmp(bstr("sc"), "decline")) {
-                       wprintf("You have declined this meeting invitation.  "
-                               "It has <b>not</b> been entered into your calendar, "
+                       wprintf(_("You have declined this meeting invitation.  "
+                               "It has <b>not</b> been entered into your calendar.")
                        );
                }
-               wprintf("and a reply has been sent to the meeting organizer."
-                       "</TD></TR></TABLE>\n"
-               );
+               wprintf(" ");
+               wprintf(_("A reply has been sent to the meeting organizer."));
+               wprintf("</TD></TR></TABLE>\n");
        } else {
-               wprintf("<IMG SRC=\"static/error.gif\" ALIGN=CENTER>"
+               wprintf("<img src=\"static/error.gif\" ALIGN=CENTER>"
                        "%s\n", &buf[4]);
        }
 
-       wprintf("<A HREF=\"/dotskip?room=");
+       wprintf("<a href=\"dotskip?room=");
        urlescputs(WC->wc_roomname);
-       wprintf("\"><BR>Return to messages</A><BR>\n");
+       wprintf("\"><br />");
+       wprintf(_("Return to messages"));
+       wprintf("</A><br />\n");
 
        wDumpContent(1);
 }
 
 
 
-/*
- * Handle an incoming RSVP
+/**
+ * \brief Handle an incoming RSVP
  */
 void handle_rsvp(void) {
        char buf[SIZ];
 
-       output_headers(3);
+       output_headers(1, 1, 2, 0, 0, 0);
 
-       wprintf("<TABLE WIDTH=100%% BORDER=0 BGCOLOR=\"#007700\"><TR><TD>"
-               "<SPAN CLASS=\"titlebar\">"
-               "Update your calendar with this RSVP</SPAN>"
-               "</TD></TR></TABLE><BR>\n"
+       wprintf("<div id=\"banner\">\n");
+       wprintf("<TABLE WIDTH=100%% BORDER=0 BGCOLOR=\"#444455\"><TR><TD>"
+               "<SPAN CLASS=\"titlebar\">");
+       wprintf(_("Update your calendar with this RSVP"));
+       wprintf("</SPAN>"
+               "</TD></TR></TABLE>\n"
+               "</div>\n<div id=\"content\">\n"
        );
 
        serv_printf("ICAL handle_rsvp|%s|%s|%s|",
@@ -423,89 +430,77 @@ void handle_rsvp(void) {
                bstr("cal_partnum"),
                bstr("sc")
        );
-       serv_gets(buf);
+       serv_getln(buf, sizeof buf);
 
        if (buf[0] == '2') {
                wprintf("<TABLE BORDER=0><TR><TD>"
-                       "<IMG SRC=\"static/vcalendar.gif\" ALIGN=CENTER>"
+                       "<img src=\"static/calarea_48x.gif\" ALIGN=CENTER>"
                        "</TD><TD>"
                );
                if (!strcasecmp(bstr("sc"), "update")) {
-                       wprintf("Your calendar has been updated "
-                               "to reflect this RSVP."
-                       );
+                       wprintf(_("Your calendar has been updated to reflect this RSVP."));
                } else if (!strcasecmp(bstr("sc"), "ignore")) {
-                       wprintf("You have chosen to ignore this RSVP. "
-                               "Your calendar has <b>not</b> been updated."
+                       wprintf(_("You have chosen to ignore this RSVP. "
+                               "Your calendar has <b>not</b> been updated.")
                        );
                }
                wprintf("</TD></TR></TABLE>\n"
                );
        } else {
-               wprintf("<IMG SRC=\"static/error.gif\" ALIGN=CENTER>"
+               wprintf("<img src=\"static/error.gif\" ALIGN=CENTER>"
                        "%s\n", &buf[4]);
        }
 
-       wprintf("<A HREF=\"/dotskip?room=");
+       wprintf("<a href=\"dotskip?room=");
        urlescputs(WC->wc_roomname);
-       wprintf("\"><BR>Return to messages</A><BR>\n");
+       wprintf("\"><br />");
+       wprintf(_("Return to messages"));
+       wprintf("</A><br />\n");
 
        wDumpContent(1);
 }
 
 
 
-
-/*****************************************************************************/
+/*@}*/
+/*-----------------------------------------------------------------------**/
 
 
 
-/*
- * Display handlers for message reading
+/**
+ * \defgroup MsgDisplayHandlers Display handlers for message reading 
+ * \ingroup Calendaring
  */
 
+/*@{*/
 
 
-/*
+
+/**
+ * \brief get items, keep them.
  * If we're reading calendar items, just store them for now.  We have to
  * sort and re-output them later when we draw the calendar.
+ * \param cal Our calendar to process
+ * \param msgnum number of the mesage in our db
  */
 void display_individual_cal(icalcomponent *cal, long msgnum) {
 
        WC->num_cal += 1;
 
        WC->disp_cal = realloc(WC->disp_cal,
-                       (sizeof(icalcomponent *) * WC->num_cal) );
-       WC->disp_cal[WC->num_cal - 1] = icalcomponent_new_clone(cal);
+                       (sizeof(struct disp_cal) * WC->num_cal) );
+       WC->disp_cal[WC->num_cal - 1].cal = icalcomponent_new_clone(cal);
 
-       WC->cal_msgnum = realloc(WC->cal_msgnum,
-                       (sizeof(long) * WC->num_cal) );
-       WC->cal_msgnum[WC->num_cal - 1] = msgnum;
+       WC->disp_cal[WC->num_cal - 1].cal_msgnum = msgnum;
 }
 
 
 
 /*
- * Display a task in the task list
- */
-void display_individual_task(icalcomponent *vtodo, long msgnum) {
-       icalproperty *p;
-
-       p = icalcomponent_get_first_property(vtodo, ICAL_SUMMARY_PROPERTY);
-       wprintf("<A HREF=\"/display_edit_task?msgnum=%ld&taskrm=", msgnum);
-       urlescputs(WC->wc_roomname);
-       wprintf("\">");
-       if (p != NULL) {
-               escputs((char *)icalproperty_get_comment(p));
-       }
-       wprintf("</A><BR>\n");
-}
-
-
-/*
+ * \brief edit a task
  * Display a task by itself (for editing)
- *
- * ok for complete vcalendar objects
+ * \param supplied_vtodo the todo item we want to edit
+ * \param msgnum number of the mesage in our db
  */
 void display_edit_individual_task(icalcomponent *supplied_vtodo, long msgnum) {
        icalcomponent *vtodo;
@@ -519,7 +514,8 @@ void display_edit_individual_task(icalcomponent *supplied_vtodo, long msgnum) {
        if (supplied_vtodo != NULL) {
                vtodo = supplied_vtodo;
 
-               /* If we're looking at a fully encapsulated VCALENDAR
+               /**
+                * If we're looking at a fully encapsulated VCALENDAR
                 * rather than a VTODO component, attempt to use the first
                 * relevant VTODO subcomponent.  If there is none, the
                 * NULL returned by icalcomponent_get_first_component() will
@@ -540,26 +536,40 @@ void display_edit_individual_task(icalcomponent *supplied_vtodo, long msgnum) {
                created_new_vtodo = 1;
        }
 
-       output_headers(3);
-       wprintf("<TABLE WIDTH=100%% BORDER=0 BGCOLOR=\"#007700\"><TR><TD>"
-               "<SPAN CLASS=\"titlebar\">Edit task</SPAN>"
-               "</TD></TR></TABLE><BR>\n"
+       output_headers(1, 1, 2, 0, 0, 0);
+       wprintf("<div id=\"banner\">\n"
+               "<TABLE WIDTH=100%% BORDER=0 BGCOLOR=\"#444455\"><TR>"
+               "<TD><img src=\"static/taskmanag_48x.gif\"></TD>"
+               "<td><SPAN CLASS=\"titlebar\">");
+       wprintf(_("Edit task"));
+       wprintf("</SPAN>"
+               "</TD></TR></TABLE>\n"
+               "</div>\n<div id=\"content\">\n"
        );
 
-       wprintf("<FORM METHOD=\"POST\" ACTION=\"/save_task\">\n");
+       wprintf("<div class=\"fix_scrollbar_bug\">"
+               "<table border=0 width=100%% bgcolor=\"#ffffff\"><tr><td>");
+       
+       wprintf("<FORM METHOD=\"POST\" action=\"save_task\">\n");
        wprintf("<INPUT TYPE=\"hidden\" NAME=\"msgnum\" VALUE=\"%ld\">\n",
                msgnum);
 
-       wprintf("Summary: "
+       wprintf("<TABLE border=0>\n");
+
+       wprintf("<TR><TD>");
+       wprintf(_("Summary:"));
+       wprintf("</TD><TD>"
                "<INPUT TYPE=\"text\" NAME=\"summary\" "
                "MAXLENGTH=\"64\" SIZE=\"64\" VALUE=\"");
        p = icalcomponent_get_first_property(vtodo, ICAL_SUMMARY_PROPERTY);
        if (p != NULL) {
                escputs((char *)icalproperty_get_comment(p));
        }
-       wprintf("\"><BR>\n");
+       wprintf("\"></TD></TR>\n");
 
-       wprintf("Start date: ");
+       wprintf("<TR><TD>");
+       wprintf(_("Start date:"));
+       wprintf("</TD><TD>");
        p = icalcomponent_get_first_property(vtodo, ICAL_DTSTART_PROPERTY);
        if (p != NULL) {
                t = icalproperty_get_dtstart(p);
@@ -568,9 +578,11 @@ void display_edit_individual_task(icalcomponent *supplied_vtodo, long msgnum) {
                t = icaltime_from_timet(now, 0);
        }
        display_icaltimetype_as_webform(&t, "dtstart");
-       wprintf("<BR>\n");
+       wprintf("</TD></TR>\n");
 
-       wprintf("Due date: ");
+       wprintf("<TR><TD>");
+       wprintf(_("Due date:"));
+       wprintf("</TD><TD>");
        p = icalcomponent_get_first_property(vtodo, ICAL_DUE_PROPERTY);
        if (p != NULL) {
                t = icalproperty_get_due(p);
@@ -579,27 +591,34 @@ void display_edit_individual_task(icalcomponent *supplied_vtodo, long msgnum) {
                t = icaltime_from_timet(now, 0);
        }
        display_icaltimetype_as_webform(&t, "due");
-       wprintf("<BR>\n");
-
-       wprintf("<CENTER><TEXTAREA NAME=\"description\" wrap=soft "
+       wprintf("</TD></TR>\n");
+       wprintf("<TR><TD>");
+       wprintf(_("Description:"));
+       wprintf("</TD><TD>");
+       wprintf("<TEXTAREA NAME=\"description\" wrap=soft "
                "ROWS=10 COLS=80 WIDTH=80>\n"
        );
        p = icalcomponent_get_first_property(vtodo, ICAL_DESCRIPTION_PROPERTY);
        if (p != NULL) {
                escputs((char *)icalproperty_get_comment(p));
        }
-       wprintf("</TEXTAREA><BR>\n");
+       wprintf("</TEXTAREA></TD></TR></TABLE>\n");
 
-       wprintf("<INPUT TYPE=\"submit\" NAME=\"sc\" VALUE=\"Save\">"
+       wprintf("<CENTER>"
+               "<INPUT TYPE=\"submit\" NAME=\"save_button\" VALUE=\"%s\">"
                "&nbsp;&nbsp;"
-               "<INPUT TYPE=\"submit\" NAME=\"sc\" VALUE=\"Delete\">\n"
+               "<INPUT TYPE=\"submit\" NAME=\"delete_button\" VALUE=\"%s\">\n"
                "&nbsp;&nbsp;"
-               "<INPUT TYPE=\"submit\" NAME=\"sc\" VALUE=\"Cancel\">\n"
-               "</CENTER>\n"
+               "<INPUT TYPE=\"submit\" NAME=\"cancel_button\" VALUE=\"%s\">\n"
+               "</CENTER>\n",
+               _("Save"),
+               _("Delete"),
+               _("Cancel")
        );
 
        wprintf("</FORM>\n");
 
+       wprintf("</td></tr></table></div>\n");
        wDumpContent(1);
 
        if (created_new_vtodo) {
@@ -608,20 +627,24 @@ void display_edit_individual_task(icalcomponent *supplied_vtodo, long msgnum) {
 }
 
 /*
- * Save an edited task
- *
- * ok 
+ * \brief Save an edited task
+ * \param supplied_vtodo the task to save
+ * \param msgnum number of the mesage in our db
  */
 void save_individual_task(icalcomponent *supplied_vtodo, long msgnum) {
        char buf[SIZ];
        int delete_existing = 0;
        icalproperty *prop;
-       icalcomponent *vtodo;
+       icalcomponent *vtodo, *encaps;
        int created_new_vtodo = 0;
+       int i;
+       int sequence = 0;
+       struct icaltimetype t;
 
        if (supplied_vtodo != NULL) {
                vtodo = supplied_vtodo;
-               /* If we're looking at a fully encapsulated VCALENDAR
+               /**
+                * If we're looking at a fully encapsulated VCALENDAR
                 * rather than a VTODO component, attempt to use the first
                 * relevant VTODO subcomponent.  If there is none, the
                 * NULL returned by icalcomponent_get_first_component() will
@@ -642,9 +665,9 @@ void save_individual_task(icalcomponent *supplied_vtodo, long msgnum) {
                created_new_vtodo = 1;
        }
 
-       if (!strcasecmp(bstr("sc"), "Save")) {
+       if (strlen(bstr("save_button")) > 0) {
 
-               /* Replace values in the component with ones from the form */
+               /** Replace values in the component with ones from the form */
 
                while (prop = icalcomponent_get_first_property(vtodo,
                      ICAL_SUMMARY_PROPERTY), prop != NULL) {
@@ -667,10 +690,9 @@ void save_individual_task(icalcomponent *supplied_vtodo, long msgnum) {
                        icalcomponent_remove_property(vtodo, prop);
                        icalproperty_free(prop);
                }
+               icaltime_from_webform(&t, "dtstart");
                icalcomponent_add_property(vtodo,
-                       icalproperty_new_dtstart(
-                               icaltime_from_webform("dtstart")
-                       )
+                       icalproperty_new_dtstart(t)
                );
        
                while (prop = icalcomponent_get_first_property(vtodo,
@@ -678,58 +700,99 @@ void save_individual_task(icalcomponent *supplied_vtodo, long msgnum) {
                        icalcomponent_remove_property(vtodo, prop);
                        icalproperty_free(prop);
                }
+               icaltime_from_webform(&t, "due");
                icalcomponent_add_property(vtodo,
-                       icalproperty_new_due(
-                               icaltime_from_webform("due")
-                       )
+                       icalproperty_new_due(t)
                );
-       
+
+               /** Give this task a UID if it doesn't have one. */
+               lprintf(9, "Give this task a UID if it doesn't have one.\n");
+               if (icalcomponent_get_first_property(vtodo,
+                  ICAL_UID_PROPERTY) == NULL) {
+                       generate_uuid(buf);
+                       icalcomponent_add_property(vtodo,
+                               icalproperty_new_uid(buf)
+                       );
+               }
+
+               /** Increment the sequence ID */
+               lprintf(9, "Increment the sequence ID\n");
+               while (prop = icalcomponent_get_first_property(vtodo,
+                     ICAL_SEQUENCE_PROPERTY), (prop != NULL) ) {
+                       i = icalproperty_get_sequence(prop);
+                       lprintf(9, "Sequence was %d\n", i);
+                       if (i > sequence) sequence = i;
+                       icalcomponent_remove_property(vtodo, prop);
+                       icalproperty_free(prop);
+               }
+               ++sequence;
+               lprintf(9, "New sequence is %d.  Adding...\n", sequence);
+               icalcomponent_add_property(vtodo,
+                       icalproperty_new_sequence(sequence)
+               );
+
+               /**
+                * Encapsulate event into full VCALENDAR component.  Clone it first,
+                * for two reasons: one, it's easier to just free the whole thing
+                * when we're done instead of unbundling, but more importantly, we
+                * can't encapsulate something that may already be encapsulated
+                * somewhere else.
+                */
+               lprintf(9, "Encapsulating into full VCALENDAR component\n");
+               encaps = ical_encapsulate_subcomponent(icalcomponent_new_clone(vtodo));
+
                /* Serialize it and save it to the message base */
                serv_puts("ENT0 1|||4");
-               serv_gets(buf);
+               serv_getln(buf, sizeof buf);
                if (buf[0] == '4') {
                        serv_puts("Content-type: text/calendar");
                        serv_puts("");
-                       serv_puts(icalcomponent_as_ical_string(vtodo));
+                       serv_puts(icalcomponent_as_ical_string(encaps));
                        serv_puts("000");
 
-                       /* Probably not necessary; the server will see the UID
+                       /**
+                        * Probably not necessary; the server will see the UID
                         * of the object and delete the old one anyway, but
                         * just in case...
                         */
                        delete_existing = 1;
                }
+               icalcomponent_free(encaps);
        }
 
-       /*
+       /**
         * If the user clicked 'Delete' then explicitly delete the message.
         */
-       if (!strcasecmp(bstr("sc"), "Delete")) {
+       if (strlen(bstr("delete_button")) > 0) {
                delete_existing = 1;
        }
 
        if ( (delete_existing) && (msgnum > 0L) ) {
                serv_printf("DELE %ld", atol(bstr("msgnum")));
-               serv_gets(buf);
+               serv_getln(buf, sizeof buf);
        }
 
        if (created_new_vtodo) {
                icalcomponent_free(vtodo);
        }
 
-       /* Go back to the task list */
+       /** Go back to the task list */
        readloop("readfwd");
 }
 
 
 
-/*
+/**
+ * \brief generic item handler
  * Code common to all display handlers.  Given a message number and a MIME
  * type, we load the message and hunt for that MIME type.  If found, we load
  * the relevant part, deserialize it into a libical component, filter it for
  * the requested object type, and feed it to the specified handler.
+ * \param mimetype mimetyp of our object
+ * \param which_kind sort of ical type
+ * \param msgnum number of the mesage in our db
+ * \param callback a funcion \todo
  *
- * ok
  */
 void display_using_handler(long msgnum,
                        char *mimetype,
@@ -748,15 +811,15 @@ void display_using_handler(long msgnum,
 
        sprintf(buf, "MSG0 %ld|1", msgnum);     /* ask for headers only */
        serv_puts(buf);
-       serv_gets(buf);
+       serv_getln(buf, sizeof buf);
        if (buf[0] != '1') return;
 
-       while (serv_gets(buf), strcmp(buf, "000")) {
+       while (serv_getln(buf, sizeof buf), strcmp(buf, "000")) {
                if (!strncasecmp(buf, "part=", 5)) {
-                       extract(mime_filename, &buf[5], 1);
-                       extract(mime_partnum, &buf[5], 2);
-                       extract(mime_disposition, &buf[5], 3);
-                       extract(mime_content_type, &buf[5], 4);
+                       extract_token(mime_filename, &buf[5], 1, '|', sizeof mime_filename);
+                       extract_token(mime_partnum, &buf[5], 2, '|', sizeof mime_partnum);
+                       extract_token(mime_disposition, &buf[5], 3, '|', sizeof mime_disposition);
+                       extract_token(mime_content_type, &buf[5], 4, '|', sizeof mime_content_type);
                        mime_length = extract_int(&buf[5], 5);
 
                        if (!strcasecmp(mime_content_type, "text/calendar")) {
@@ -775,12 +838,12 @@ void display_using_handler(long msgnum,
 
                                ical_dezonify(cal);
 
-                               /* Simple components of desired type */
+                               /** Simple components of desired type */
                                if (icalcomponent_isa(cal) == which_kind) {
                                        callback(cal, msgnum);
                                }
 
-                               /* Subcomponents of desired type */
+                               /** Subcomponents of desired type */
                                for (c = icalcomponent_get_first_component(cal,
                                    which_kind);
                                    (c != 0);
@@ -796,39 +859,53 @@ void display_using_handler(long msgnum,
 
 }
 
+/**
+ * \brief display whole calendar
+ * \param msgnum number of the mesage in our db
+ */
 void display_calendar(long msgnum) {
        display_using_handler(msgnum, "text/calendar",
                                ICAL_VEVENT_COMPONENT,
                                display_individual_cal);
 }
 
+/**
+ * \brief display whole taksview
+ * \param msgnum number of the mesage in our db
+ */
 void display_task(long msgnum) {
        display_using_handler(msgnum, "text/calendar",
                                ICAL_VTODO_COMPONENT,
-                               display_individual_task);
+                               display_individual_cal);
 }
 
+/**
+ * \brief display the editor component for a task
+ */
 void display_edit_task(void) {
        long msgnum = 0L;
 
-       /* Force change the room if we have to */
+       /** Force change the room if we have to */
        if (strlen(bstr("taskrm")) > 0) {
-               gotoroom(bstr("taskrm"), 0);
+               gotoroom(bstr("taskrm"));
        }
 
        msgnum = atol(bstr("msgnum"));
        if (msgnum > 0L) {
-               /* existing task */
+               /** existing task */
                display_using_handler(msgnum, "text/calendar",
                                ICAL_VTODO_COMPONENT,
                                display_edit_individual_task);
        }
        else {
-               /* new task */
+               /** new task */
                display_edit_individual_task(NULL, 0L);
        }
 }
 
+/**
+ *\brief save an edited task
+ */
 void save_task(void) {
        long msgnum = 0L;
 
@@ -843,6 +920,9 @@ void save_task(void) {
        }
 }
 
+/**
+ * \brief display the editor component for an event
+ */
 void display_edit_event(void) {
        long msgnum = 0L;
 
@@ -859,6 +939,9 @@ void display_edit_event(void) {
        }
 }
 
+/**
+ * \brief save an edited event
+ */
 void save_event(void) {
        long msgnum = 0L;
 
@@ -878,34 +961,36 @@ void save_event(void) {
 
 
 
-/*
- * freebusy display (for client software)
+/**
+ * \brief freebusy display (for client software)
+ * \param req dunno. ?????
  */
 void do_freebusy(char *req) {
        char who[SIZ];
        char buf[SIZ];
        char *fb;
 
-       extract_token(who, req, 1, ' ');
+       extract_token(who, req, 1, ' ', sizeof who);
        if (!strncasecmp(who, "/freebusy/", 10)) {
                strcpy(who, &who[10]);
        }
        unescape_input(who);
 
        if ( (!strcasecmp(&who[strlen(who)-4], ".vcf"))
-          || (!strcasecmp(&who[strlen(who)-4], ".vcf")) ) {
+          || (!strcasecmp(&who[strlen(who)-4], ".ifb"))
+          || (!strcasecmp(&who[strlen(who)-4], ".vfb")) ) {
                who[strlen(who)-4] = 0;
        }
 
        lprintf(9, "freebusy requested for <%s>\n", who);
        serv_printf("ICAL freebusy|%s", who);
-       serv_gets(buf);
+       serv_getln(buf, sizeof buf);
 
        if (buf[0] != '1') {
-               wprintf("HTTP/1.0 404 %s\n", &buf[4]);
-               output_headers(0);
-               wprintf("Content-Type: text/plain\n");
-               wprintf("\n");
+               wprintf("HTTP/1.1 404 %s\n", &buf[4]);
+               output_headers(0, 0, 0, 0, 0, 0);
+               wprintf("Content-Type: text/plain\r\n");
+               wprintf("\r\n");
                wprintf("%s\n", &buf[4]);
                return;
        }
@@ -918,3 +1003,6 @@ void do_freebusy(char *req) {
 
 
 #endif /* WEBCIT_WITH_CALENDAR_SERVICE */
+
+
+/*@}*/