/*
* $Id$
- *
- * Miscellaneous functions which handle calendar components.
*/
-
-#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>
+/**
+ * \defgroup MiscCal Miscellaneous functions which handle calendar components.
+ */
+/*@{*/
#include "webcit.h"
#include "webserver.h"
-char *months[] = {
- "January", "February", "March", "April", "May", "June", "July",
- "August", "September", "October", "November", "December"
+/* \todo FIXME ... this needs to be internationalized */
+/** Month Strings. */
+char *months[] = {
+ "January",
+ "February",
+ "March",
+ "April",
+ "May",
+ "June",
+ "July",
+ "August",
+ "September",
+ "October",
+ "November",
+ "December"
};
-char *days[] = {
- "Sunday", "Monday", "Tuesday", "Wednesday",
- "Thursday", "Friday", "Saturday"
+/** Day Strings */
+char *days[] = {
+ "Sunday",
+ "Monday",
+ "Tuesday",
+ "Wednesday",
+ "Thursday",
+ "Friday",
+ "Saturday"
};
+/** Hour strings */
char *hourname[] = {
"12am", "1am", "2am", "3am", "4am", "5am", "6am",
"7am", "8am", "9am", "10am", "11am", "12pm",
#ifdef WEBCIT_WITH_CALENDAR_SERVICE
-/*
+/**
+ * \brief display and edit date/time
* The display_icaltimetype_as_webform() and icaltime_from_webform() functions
* handle the display and editing of date/time properties in web pages. The
* first one converts an icaltimetype into valid HTML markup -- a series of form
* property (for example, a start and end time) by ensuring the field names are
* unique within the form.
*
- * NOTE: These functions assume that the icaltimetype being edited is in UTC, and
+ * \todo NOTE: These functions assume that the icaltimetype being edited is in UTC, and
* will convert to/from local time for editing. "local" in this case is assumed
* to be the time zone in which the WebCit server is running. A future improvement
* might be to allow the user to specify his/her timezone.
+ * \param t the time we want to parse
+ * \param prefix ???? \todo
*/
localtime_r(&tt, &tm);
}
- wprintf("Month: ");
+ wprintf(_("Month: "));
wprintf("<SELECT NAME=\"%s_month\" SIZE=\"1\">\n", prefix);
for (i=0; i<=11; ++i) {
wprintf("<OPTION %s VALUE=\"%d\">%s</OPTION>\n",
}
wprintf("</SELECT>\n");
- wprintf("Day: ");
+ wprintf(_("Day: "));
wprintf("<SELECT NAME=\"%s_day\" SIZE=\"1\">\n", prefix);
for (i=1; i<=31; ++i) {
wprintf("<OPTION %s VALUE=\"%d\">%d</OPTION>\n",
}
wprintf("</SELECT>\n");
- wprintf("Year: ");
+ wprintf(_("Year: "));
wprintf("<SELECT NAME=\"%s_year\" SIZE=\"1\">\n", prefix);
if ((this_year - t->year) > span) {
wprintf("<OPTION SELECTED VALUE=\"%d\">%d</OPTION>\n",
}
wprintf("</SELECT>\n");
- wprintf("Hour: ");
+ wprintf(_("Hour: "));
wprintf("<SELECT NAME=\"%s_hour\" SIZE=\"1\">\n", prefix);
for (i=0; i<=23; ++i) {
}
wprintf("</SELECT>\n");
- wprintf("Minute: ");
+ wprintf(_("Minute: "));
wprintf("<SELECT NAME=\"%s_minute\" SIZE=\"1\">\n", prefix);
for (i=0; i<=59; ++i) {
if ( (i % 5 == 0) || (tm.tm_min == i) ) {
wprintf("</SELECT>\n");
}
-
+/**
+ *\brief Get time from form
+ * get the time back from the user and convert it into internal structs.
+ * \param t our time element
+ * \param prefix whats that\todo ????
+ */
void icaltime_from_webform(struct icaltimetype *t, char *prefix) {
char vname[32];
time_t tt;
memcpy(t, &t2, sizeof(struct icaltimetype));
}
+/**
+ *\brief Get time from form
+ * get the time back from the user and convert it into internal structs.
+ * \param t our time element
+ * \param prefix whats that\todo ????
+ */
void icaltime_from_webform_dateonly(struct icaltimetype *t, char *prefix) {
char vname[32];
}
-/*
+/**
+ * \brief Render PAPSTAT
* Render a PARTSTAT parameter as a string (and put it in parentheses)
+ * \param buf the string to put it to
+ * \param attendee the attendee to textify
*/
void partstat_as_string(char *buf, icalproperty *attendee) {
icalparameter *partstat_param;
icalparameter_partstat partstat;
- strcpy(buf, "(status unknown)");
+ strcpy(buf, _("(status unknown)"));
partstat_param = icalproperty_get_first_parameter(
attendee,
strcpy(buf, "(x)");
break;
case ICAL_PARTSTAT_NEEDSACTION:
- strcpy(buf, "(needs action)");
+ strcpy(buf, _("(needs action)"));
break;
case ICAL_PARTSTAT_ACCEPTED:
- strcpy(buf, "(accepted)");
+ strcpy(buf, _("(accepted)"));
break;
case ICAL_PARTSTAT_DECLINED:
- strcpy(buf, "(declined)");
+ strcpy(buf, _("(declined)"));
break;
case ICAL_PARTSTAT_TENTATIVE:
- strcpy(buf, "(tenative)");
+ strcpy(buf, _("(tenative)"));
break;
case ICAL_PARTSTAT_DELEGATED:
- strcpy(buf, "(delegated)");
+ strcpy(buf, _("(delegated)"));
break;
case ICAL_PARTSTAT_COMPLETED:
- strcpy(buf, "(completed)");
+ strcpy(buf, _("(completed)"));
break;
case ICAL_PARTSTAT_INPROCESS:
- strcpy(buf, "(in process)");
+ strcpy(buf, _("(in process)"));
break;
case ICAL_PARTSTAT_NONE:
- strcpy(buf, "(none)");
+ strcpy(buf, _("(none)"));
break;
}
}
-/*
+/**
+ * \brief embedd
* Utility function to encapsulate a subcomponent into a full VCALENDAR
+ * \param subcomp the component to encapsulate
+ * \returns the meta object ???
*/
icalcomponent *ical_encapsulate_subcomponent(icalcomponent *subcomp) {
icalcomponent *encaps;
- lprintf(9, "ical_encapsulate_subcomponent() called\n");
+ /* lprintf(9, "ical_encapsulate_subcomponent() called\n"); */
if (subcomp == NULL) {
lprintf(3, "ERROR: called with NULL argument!\n");
return NULL;
}
- /* If we're already looking at a full VCALENDAR component,
+ /**
+ * If we're already looking at a full VCALENDAR component,
* don't bother ... just return itself.
*/
if (icalcomponent_isa(subcomp) == ICAL_VCALENDAR_COMPONENT) {
- lprintf(9, "Already encapsulated. Returning itself.\n");
return subcomp;
}
- /* Encapsulate the VEVENT component into a complete VCALENDAR */
+ /** Encapsulate the VEVENT component into a complete VCALENDAR */
encaps = icalcomponent_new(ICAL_VCALENDAR_COMPONENT);
if (encaps == NULL) {
- lprintf(3, "Error at %s:%d - could not allocate component!\n",
+ lprintf(3, "%s:%d: Error - could not allocate component!\n",
__FILE__, __LINE__);
return NULL;
}
- /* Set the Product ID */
+ /** Set the Product ID */
icalcomponent_add_property(encaps, icalproperty_new_prodid(PRODID));
- /* Set the Version Number */
+ /** Set the Version Number */
icalcomponent_add_property(encaps, icalproperty_new_version("2.0"));
- /* Encapsulate the subcomponent inside */
- lprintf(9, "Doing the encapsulation\n");
+ /** Encapsulate the subcomponent inside */
+ /* lprintf(9, "Doing the encapsulation\n"); */
icalcomponent_add_component(encaps, subcomp);
- /* Convert all timestamps to UTC so we don't have to deal with
+ /** Convert all timestamps to UTC so we don't have to deal with
* stupid VTIMEZONE crap.
*/
ical_dezonify(encaps);
- /* Return the object we just created. */
+ /** Return the object we just created. */
return(encaps);
}
#endif
+/*@}*/