Done with doxygenizing

[citadel.git] / webcit / who.c

diff --git a/webcit/who.c b/webcit/who.c
index f27ccdecf20f5d061bb006eaed086bf92ca8d9d2..abd807705c2da521160562ac6fd838af96e93b11 100644 (file)
--- a/webcit/who.c
+++ b/webcit/who.c
@@ -1,15 +1,16 @@
 /*
  * $Id$
- *
- * Display a list of all users currently logged on to the Citadel server.
  */
-
+/**
+ * \defgroup DislpayWho Display a list of all users currently logged on to the Citadel server.
+ */
+/*@{*/
 #include "webcit.h"
 
 
 
-/*
- * Display inner div of Wholist
+/**
+ * \brief Display inner div of Wholist
  */
 void who_inner_div(void) {
        char buf[SIZ], user[SIZ], room[SIZ], host[SIZ],
@@ -64,7 +65,7 @@ void who_inner_div(void) {
                        }
                        wprintf("</td>");
 
-                       /* (link to page this user) */
+                       /** (link to page this user) */
                        wprintf("<td><a href=\"display_page?recp=");
                        urlescputs(user);
                        wprintf("\">"
@@ -74,7 +75,7 @@ void who_inner_div(void) {
                                " border=\"0\" /></a> ");
                        wprintf("</td>");
 
-                       /* (idle flag) */
+                       /** (idle flag) */
                        wprintf("<td>");
                        if ((now - last_activity) > 900L) {
                                wprintf(" "
@@ -92,14 +93,14 @@ void who_inner_div(void) {
 
 
 
-                       /* username (link to user bio/photo page) */
-                       wprintf("<a href=\"/showuser?who=");
+                       /** username (link to user bio/photo page) */
+                       wprintf("<a href=\"showuser?who=");
                        urlescputs(user);
                        wprintf("\">");
                        escputs(user);
                        wprintf("</a>");
 
-                       /* room */
+                       /** room */
                        wprintf("</td>\n\t<td>");
                        escputs(room);
                        if (strlen(realroom) > 0) {
@@ -109,7 +110,7 @@ void who_inner_div(void) {
                        }
                        wprintf("</td>\n\t<td>");
 
-                       /* hostname */
+                       /** hostname */
                        escputs(host);
                        if (strlen(realhost) > 0) {
                                wprintf("<br /><i>");
@@ -123,8 +124,8 @@ void who_inner_div(void) {
 }
 
 
-/*
- * who is on?
+/**
+ * \brief who is on?
  */
 void who(void)
 {
@@ -167,7 +168,8 @@ void who(void)
        );
        wprintf("</div>\n");
 
-       /* JavaScript to make the ajax refresh happen:
+       /**
+        * JavaScript to make the ajax refresh happen:
         * See http://www.sergiopereira.com/articles/prototype.js.html for info on Ajax.PeriodicalUpdater
         * It wants: 1. The div being updated
         *           2. The URL of the update source
@@ -175,14 +177,16 @@ void who(void)
         */
        wprintf(
                "<script type=\"text/javascript\">                                      "
-               " new Ajax.PeriodicalUpdater('fix_scrollbar_bug', '/who_inner_html',    "
+               " new Ajax.PeriodicalUpdater('fix_scrollbar_bug', 'who_inner_html',     "
                "                            { method: 'get', frequency: 30 }  );       "
                "</script>                                                              \n"
        );
        wDumpContent(1);
 }
 
-
+/**
+ * \brief end session \todo what??? does this belong here? 
+ */
 void terminate_session(void)
 {
        char buf[SIZ];
@@ -193,8 +197,8 @@ void terminate_session(void)
 }
 
 
-/*
- * Change your session info (fake roomname and hostname)
+/**
+ * \brief Change your session info (fake roomname and hostname)
  */
 void edit_me(void)
 {
@@ -203,17 +207,17 @@ void edit_me(void)
        if (strlen(bstr("change_room_name_button")) > 0) {
                serv_printf("RCHG %s", bstr("fake_roomname"));
                serv_getln(buf, sizeof buf);
-               http_redirect("/who");
+               http_redirect("who");
        } else if (strlen(bstr("change_host_name_button")) > 0) {
                serv_printf("HCHG %s", bstr("fake_hostname"));
                serv_getln(buf, sizeof buf);
-               http_redirect("/who");
+               http_redirect("who");
        } else if (strlen(bstr("change_user_name_button")) > 0) {
                serv_printf("UCHG %s", bstr("fake_username"));
                serv_getln(buf, sizeof buf);
-               http_redirect("/who");
+               http_redirect("who");
        } else if (strlen(bstr("cancel_button")) > 0) {
-               http_redirect("/who");
+               http_redirect("who");
        } else {
                output_headers(1, 1, 0, 0, 0, 0);
 
@@ -271,3 +275,6 @@ void edit_me(void)
                wDumpContent(1);
        }
 }
+
+
+/*@}*/