* Doxygen groups. Sorted the files into groups. so now we have a nice structure

[citadel.git] / webcit / calendar_tools.c

diff --git a/webcit/calendar_tools.c b/webcit/calendar_tools.c
index fa8bd902039931aeda48553b51effacdec6324ee..72ee508a6ce3f7e5b71928937f9525981f166129 100644 (file)
--- a/webcit/calendar_tools.c
+++ b/webcit/calendar_tools.c
@@ -1,38 +1,15 @@
 /*
  * $Id$
- *
- * Miscellaneous functions which handle calendar components.
  */
-
+/**
+ * \defgroup MiscCal Miscellaneous functions which handle calendar components.
+ * \ingroup Calendaring
+ */
+/*@{*/
 #include "webcit.h"
 #include "webserver.h"
 
-/* FIXME ... this needs to be internationalized */
-char *months[] = {
-       "January",
-       "February",
-       "March",
-       "April",
-       "May",
-       "June",
-       "July",
-       "August",
-       "September",
-       "October",
-       "November",
-       "December"
-};
-
-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",
@@ -42,7 +19,8 @@ char *hourname[] = {
 
 #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
@@ -53,10 +31,12 @@ char *hourname[] = {
  * 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
  */
 
 
@@ -159,7 +139,12 @@ void display_icaltimetype_as_webform(struct icaltimetype *t, char *prefix) {
        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;
@@ -180,6 +165,12 @@ void icaltime_from_webform(struct icaltimetype *t, char *prefix) {
        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];
@@ -194,8 +185,11 @@ void icaltime_from_webform_dateonly(struct icaltimetype *t, char *prefix) {
 }
 
 
-/*
+/**
+ * \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;
@@ -244,51 +238,54 @@ void partstat_as_string(char *buf, icalproperty *attendee) {
 }
 
 
-/*
+/**
+ * \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);
 }
 
@@ -296,3 +293,4 @@ icalcomponent *ical_encapsulate_subcomponent(icalcomponent *subcomp) {
 
 
 #endif
+/*@}*/