Began making changes to do better handling of character sets.
[citadel.git] / webcit / mainmenu.c
index 8afd567d024aa50627404ced54a16329244fd40b..3f66e6d588578f3257cb3411cbad338809d56c42 100644 (file)
@@ -1,20 +1,22 @@
 /*
  * $Id$
- *
- * Displays the "advanced" (main) menu.
+ */
+/**
+ * \defgroup DispAdvancedMenu Displays the "advanced" (main) menu.
+ * \ingroup MenuInfrastructure
  *
  */
-
+/*@{*/
 #include "webcit.h"
 
-/*
- * The Main Menu
+/**
+ * \brief The Main Menu
  */
 void display_main_menu(void)
 {
-       output_headers(1, 1, 1, 0, 0, 0, 0);
+       output_headers(1, 1, 1, 0, 0, 0);
 
-       wprintf("<div id=\"fix_scrollbar_bug\">"
+       wprintf("<div class=\"fix_scrollbar_bug\">"
                "<TABLE WIDTH=100%%>"
                "<TR><TD COLSPAN=2>\n");
 
@@ -24,15 +26,15 @@ void display_main_menu(void)
        wprintf("\n"
                "<TABLE border=0 cellspacing=1 cellpadding=1 width=100%%>"
                "<TR>"
-               "<TD>");        /* start of first column */
+               "<TD>");        /**< start of first column */
 
-       wprintf("<A HREF=\"/knrooms\"><span class=\"mainmenu\">");
+       wprintf("<a href=\"knrooms\"><span class=\"mainmenu\">");
        wprintf(_("List known rooms"));
        wprintf("</span></A><br /><span class=\"menudesc\">");
        wprintf(_("Where can I go from here?"));
        wprintf("</span><br />\n");
 
-       wprintf("<A HREF=\"/gotonext\">"
+       wprintf("<a href=\"gotonext\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Goto next room"));
        wprintf("</span></A><br />"
@@ -40,7 +42,7 @@ void display_main_menu(void)
        wprintf(_("...with <EM>unread</EM> messages"));
        wprintf("</span><br />\n");
 
-       wprintf("<A HREF=\"/skip\">"
+       wprintf("<a href=\"skip\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Skip to next room"));
        wprintf("</span></a><br />"
@@ -50,18 +52,18 @@ void display_main_menu(void)
 
        if ((strlen(WC->ugname) > 0) && (strcasecmp(WC->ugname, WC->wc_roomname))) {
                wprintf("<br />"
-                       "<A HREF=\"/ungoto\">"
+                       "<a href=\"ungoto\">"
                        "<span class=\"mainmenu\">");
                wprintf(_("Ungoto"));
                wprintf("</span></A><br />"
                        "<span class=\"menudesc\">");
-               wprintf(_("(oops! Back to %s)"));
-               wprintf("</span>\n", WC->ugname);
+               wprintf(_("(oops! Back to %s)"), WC->ugname);
+               wprintf("</span>\n");
        }
 
        wprintf("</TD><TD>\n"); /* start of second column */
 
-       wprintf("<A HREF=\"/readnew\">"
+       wprintf("<a href=\"readnew\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Read new messages"));
        wprintf("</span></A><br />"
@@ -69,7 +71,7 @@ void display_main_menu(void)
        wprintf(_("...in this room"));
        wprintf("</span><br />\n");
 
-       wprintf("<A HREF=\"/readfwd\">"
+       wprintf("<a href=\"readfwd\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Read all messages"));
        wprintf("</span></A><br />"
@@ -77,7 +79,7 @@ void display_main_menu(void)
        wprintf(_("...old <EM>and</EM> new"));
        wprintf("</span><br />\n");
 
-       wprintf("<A HREF=\"/display_enter\">"
+       wprintf("<a href=\"display_enter\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Enter a message"));
        wprintf("</span></A><br />"
@@ -87,7 +89,7 @@ void display_main_menu(void)
 
        wprintf("</TD><TD>");   /* start of third column */
 
-       wprintf("<A HREF=\"/summary\">"
+       wprintf("<a href=\"summary\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Summary page"));
        wprintf("</span></A><br />"
@@ -95,7 +97,7 @@ void display_main_menu(void)
        wprintf(_("Summary of my account"));
        wprintf("</span><br />\n");
 
-       wprintf("<A HREF=\"/userlist\">\n"
+       wprintf("<a href=\"userlist\">\n"
                "<span class=\"mainmenu\">");
        wprintf(_("User list"));
        wprintf("</span></A><br />"
@@ -103,7 +105,7 @@ void display_main_menu(void)
        wprintf(_("(all registered users)"));
        wprintf("</span><br />\n");
 
-       wprintf("<A HREF=\"/termquit\" TARGET=\"_top\">"
+       wprintf("<a href=\"termquit\" TARGET=\"_top\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Log off"));
        wprintf("</span></A><br />"
@@ -117,30 +119,30 @@ void display_main_menu(void)
        wprintf("</TD></TR>"
                "<TR VALIGN=TOP><TD>");
 
-       svprintf("BOXTITLE", WCS_STRING, "Your info");
+       svprintf("BOXTITLE", WCS_STRING, _("Your info"));
        do_template("beginbox");
 
-       wprintf("<A HREF=\"/display_preferences\">"
+       wprintf("<a href=\"display_preferences\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Change your preferences and settings"));
        wprintf("</span><br />\n");
 
-       wprintf("<A HREF=\"/display_reg\">"
+       wprintf("<a href=\"display_reg\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Update your contact information"));
        wprintf("</span><br />\n");
 
-       wprintf("<A HREF=\"/display_changepw\">"
+       wprintf("<a href=\"display_changepw\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Change your password"));
        wprintf("</span></A><br />\n");
 
-       wprintf("<A HREF=\"/display_editbio\">"
+       wprintf("<a href=\"display_editbio\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Enter your 'bio'"));
        wprintf("</span></a><br />\n");
 
-       wprintf("<A HREF=\"/display_editpic\">"
+       wprintf("<a href=\"display_editpic\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Edit your online photo"));
        wprintf("</span></a>\n");
@@ -153,28 +155,28 @@ void display_main_menu(void)
        do_template("beginbox");
 
        if ((WC->axlevel >= 6) || (WC->is_room_aide)) {
-               wprintf("<A HREF=\"/display_editroom\">"
+               wprintf("<a href=\"display_editroom\">"
                        "<span class=\"mainmenu\">");
                wprintf(_("Edit or delete this room"));
                wprintf("</span></A><br />\n");
        }
 
-       wprintf("<A HREF=\"/display_private\">"
+       wprintf("<a href=\"display_private\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Go to a 'hidden' room"));
        wprintf("</span></A><br />\n");
 
-       wprintf("<A HREF=\"/display_entroom\">"
+       wprintf("<a href=\"display_entroom\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Create a new room"));
        wprintf("</span></A><br />\n");
 
-       wprintf("<A HREF=\"/display_zap\">"
+       wprintf("<a href=\"display_zap\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Zap (forget) this room (%s)"), WC->wc_roomname);
        wprintf("</span></A><br />\n");
 
-       wprintf("<A HREF=\"/zapped_list\">"
+       wprintf("<a href=\"zapped_list\">"
                "<span class=\"mainmenu\">");
        wprintf(_("List all forgotten rooms"));
        wprintf("</span></A>\n");
@@ -186,12 +188,12 @@ void display_main_menu(void)
 }
 
 
-/*
- * System administration menu
+/**
+ * \brief System administration menu
  */
 void display_aide_menu(void)
 {
-       output_headers(1, 1, 2, 0, 0, 0, 0);
+       output_headers(1, 1, 2, 0, 0, 0);
        wprintf("<div id=\"banner\">\n"
                "<TABLE WIDTH=100%% BORDER=0 BGCOLOR=\"#444455\"><TR><TD>"
                "<SPAN CLASS=\"titlebar\">");
@@ -201,23 +203,23 @@ void display_aide_menu(void)
                "</div>\n<div id=\"content\">\n"
        );
 
-       wprintf("<div id=\"fix_scrollbar_bug\">"
+       wprintf("<div class=\"fix_scrollbar_bug\">"
                "<table border=0 width=100%%><tr valign=top><td>");
 
        svprintf("BOXTITLE", WCS_STRING, _("Global Configuration"));
        do_template("beginbox");
 
-       wprintf("<A HREF=\"/display_siteconfig\">"
+       wprintf("<a href=\"display_siteconfig\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Edit site-wide configuration"));
        wprintf("</span></A><br />\n");
 
-       wprintf("<A HREF=\"/display_inetconf\">"
+       wprintf("<a href=\"display_inetconf\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Domain names and Internet mail configuration"));
        wprintf("</span></a><br />\n");
 
-       wprintf("<A HREF=\"/display_netconf\">"
+       wprintf("<a href=\"display_netconf\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Configure replication with other Citadel servers"));
        wprintf("</span></A>\n");
@@ -229,12 +231,12 @@ void display_aide_menu(void)
        svprintf("BOXTITLE", WCS_STRING, _("User account management"));
        do_template("beginbox");
 
-       wprintf("<A HREF=\"/select_user_to_edit\">"
+       wprintf("<a href=\"select_user_to_edit\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Add, change, delete user accounts"));
        wprintf("</span></A><br />\n");
 
-       wprintf("<A HREF=\"/validate\">"
+       wprintf("<a href=\"validate\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Validate new users"));
        wprintf("</span></A><br />\n");
@@ -244,7 +246,7 @@ void display_aide_menu(void)
        svprintf("BOXTITLE", WCS_STRING, _("Rooms and Floors"));
        do_template("beginbox");
 
-       wprintf("<A HREF=\"/display_floorconfig\">"
+       wprintf("<a href=\"display_floorconfig\">"
                "<span class=\"mainmenu\">");
        wprintf(_("Add, change, or delete floors"));
        wprintf("</span></A>\n");
@@ -259,12 +261,12 @@ void display_aide_menu(void)
 
 
 
-/*
- * Display the screen to enter a generic server command
+/**
+ * \brief Display the screen to enter a generic server command
  */
 void display_generic(void)
 {
-       output_headers(1, 1, 2, 0, 0, 0, 0);
+       output_headers(1, 1, 2, 0, 0, 0);
        wprintf("<div id=\"banner\">\n"
                "<TABLE WIDTH=100%% BORDER=0 BGCOLOR=\"#444455\"><TR><TD>"
                "<SPAN CLASS=\"titlebar\">");
@@ -273,7 +275,7 @@ void display_generic(void)
                "</div>\n<div id=\"content\">\n"
        );
 
-       wprintf("<div id=\"fix_scrollbar_bug\">"
+       wprintf("<div class=\"fix_scrollbar_bug\">"
                "<table border=0 width=100%% bgcolor=\"#ffffff\"><tr><td>\n");
 
        wprintf("<CENTER>");
@@ -282,7 +284,7 @@ void display_generic(void)
                "then this screen will not be of much use to you."));
        wprintf("<br />\n");
 
-       wprintf("<FORM METHOD=\"POST\" ACTION=\"/do_generic\">\n");
+       wprintf("<FORM METHOD=\"POST\" action=\"do_generic\">\n");
 
        wprintf(_("Enter command:"));
        wprintf("<br /><INPUT TYPE=\"text\" NAME=\"g_cmd\" SIZE=80 MAXLENGTH=\"250\"><br />\n");
@@ -302,6 +304,9 @@ void display_generic(void)
        wDumpContent(1);
 }
 
+/**
+ * \brief Interactive window to perform generic Citadel server commands.
+ */
 void do_generic(void)
 {
        char buf[SIZ];
@@ -314,12 +319,12 @@ void do_generic(void)
                return;
        }
 
-       output_headers(1, 1, 0, 0, 0, 0, 0);
+       output_headers(1, 1, 0, 0, 0, 0);
 
        serv_printf("%s", bstr("g_cmd"));
        serv_getln(buf, sizeof buf);
 
-       svprintf("BOXTITLE", WCS_STRING, "Server command results");
+       svprintf("BOXTITLE", WCS_STRING, _("Server command results"));
        do_template("beginbox");
 
        wprintf("<TABLE border=0><TR><TD>Command:</TD><TD><TT>");
@@ -339,7 +344,7 @@ void do_generic(void)
                wprintf("000");
        }
        if (buf[0] == '4') {
-               text_to_server(bstr("g_input"), 0);
+               text_to_server(bstr("g_input"));
                serv_puts("000");
        }
        if (buf[0] == '6') {
@@ -356,24 +361,22 @@ void do_generic(void)
                free(junk);
        }
        wprintf("<hr />");
-       wprintf("<A HREF=\"/display_generic\">Enter another command</A><br />\n");
-       wprintf("<A HREF=\"/display_advanced\">Return to menu</A>\n");
+       wprintf("<a href=\"display_generic\">Enter another command</A><br />\n");
+       wprintf("<a href=\"display_advanced\">Return to menu</A>\n");
        do_template("endbox");
        wDumpContent(1);
 }
 
 
-
-
-/*
- * Display the menubar.  Set as_single_page to
- * display HTML headers and footers -- otherwise it's assumed
+/**
+ * \brief Display the menubar.  
+ * \param as_single_page Set to display HTML headers and footers -- otherwise it's assumed
  * that the menubar is being embedded in another page.
  */
 void display_menubar(int as_single_page) {
 
        if (as_single_page) {
-               output_headers(0, 0, 0, 0, 0, 0, 0);
+               output_headers(0, 0, 0, 0, 0, 0);
                wprintf("<HTML>\n"
                        "<HEAD>\n"
                        "<TITLE>MenuBar</TITLE>\n"
@@ -394,3 +397,4 @@ void display_menubar(int as_single_page) {
 }
 
 
+/*@}*/