X-Git-Url: https://code.citadel.org/?a=blobdiff_plain;f=webcit%2Fhttp_datestring.c;h=449b52c96d948d9d3be30c940b65dd8c317751a1;hb=c7a28913ad7fbcd263888e0bbb24b380d3a81b9c;hp=aa0aa6ebfb306d9ba304546e564cbce8cead66bb;hpb=9f33314bbdefcb239a5f7b7ed44aa470f12fe78b;p=citadel.git

diff --git a/webcit/http_datestring.c b/webcit/http_datestring.c
index aa0aa6ebf..449b52c96 100644
--- a/webcit/http_datestring.c
+++ b/webcit/http_datestring.c
@@ -1,25 +1,31 @@
 /*
  * $Id$
- *
- * Function to generate HTTP-compliant textual time/date stamp
+ */
+/**
+ * \defgroup HTTPDateTime Function to generate HTTP-compliant textual time/date stamp
  * (This module was lifted directly from the Citadel server source)
  *
  */
-
+/*@{*/
 #include "webcit.h"
 
+/** HTTP Months */
 static char *httpdate_months[] = {
 	"Jan", "Feb", "Mar", "Apr", "May", "Jun",
 	"Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
 };
 
+/** HTTP Weekdays */
 static char *httpdate_weekdays[] = {
 	"Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"
 };
 
 
-/*
- * Supplied with a unix timestamp, generate a textual time/date stamp
+/**
+ * \brief Supplied with a unix timestamp, generate a textual time/date stamp
+ * \param buf the return buffer
+ * \param n the size of the buffer
+ * \param xtime the time to format as string
  */
 void http_datestring(char *buf, size_t n, time_t xtime) {
 	struct tm t;
@@ -29,7 +35,7 @@ void http_datestring(char *buf, size_t n, time_t xtime) {
 
 	localtime_r(&xtime, &t);
 
-	/* Convert "seconds west of GMT" to "hours/minutes offset" */
+	/** Convert "seconds west of GMT" to "hours/minutes offset" */
 #ifdef HAVE_STRUCT_TM_TM_GMTOFF
 	offset = t.tm_gmtoff;
 #else
@@ -56,3 +62,5 @@ void http_datestring(char *buf, size_t n, time_t xtime) {
 	);
 }
 
+
+/*@}*/