Done with doxygenizing

[citadel.git] / webcit / vcard_edit.c

diff --git a/webcit/vcard_edit.c b/webcit/vcard_edit.c
index ab5c6dde547d1ff5ea29b22f28dae19112833fc9..2a77b7c38f967bdfc7f5d1f81d73886667b43183 100644 (file)
--- a/webcit/vcard_edit.c
+++ b/webcit/vcard_edit.c
@@ -1,16 +1,22 @@
 /*
  * $Id$
- *
- * Handles on-screen editing of vCard objects.
- *
  */
-
+/**
+ * \defgroup vCardEdit Handles on-screen editing of vCard objects.
+ * \ingroup WebFrontend
+ */
+/*@{*/
 #include "webcit.h"
 #include "vcard.h"
 
-/* Edit the vCard component of a MIME message.  Supply the message number
+/**
+ * \brief Edit the vCard component of a MIME message.  
+ * Supply the message number
  * and MIME part number to fetch.  Or, specify -1 for the message number
  * to start with a blank card.
+ * \param msgnum number of the item on the citadel server
+ * \param partnum what???
+ * \param return_to where to go back in the browser after edit ????
  */
 void do_edit_vcard(long msgnum, char *partnum, char *return_to) {
        char buf[SIZ];
@@ -38,7 +44,7 @@ void do_edit_vcard(long msgnum, char *partnum, char *return_to) {
        char primary_inetemail[256];
        char other_inetemail[SIZ];
        char extrafields[SIZ];
-       char displayname[256];
+       char fullname[256];
        char title[256];
        char org[256];
 
@@ -116,7 +122,7 @@ void do_edit_vcard(long msgnum, char *partnum, char *return_to) {
                        }
 
                        else if (!strcasecmp(key, "fn")) {
-                               safestrncpy(displayname, value, sizeof displayname);
+                               safestrncpy(fullname, value, sizeof fullname);
                        }
 
                        else if (!strcasecmp(key, "title")) {
@@ -169,20 +175,20 @@ void do_edit_vcard(long msgnum, char *partnum, char *return_to) {
                vcard_free(v);
        }
 
-       /* Display the form */
+       /** Display the form */
        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\">"
-               "<img src=\"/static/savecontact_48x.gif\">");
+               "<img src=\"static/savecontact_48x.gif\">");
        wprintf(_("Edit contact information"));
        wprintf("</SPAN>"
                "</TD></TR></TABLE>\n"
                "</div>\n<div id=\"content\">\n"
        );
 
-       wprintf("<FORM METHOD=\"POST\" action=\"/submit_vcard\">\n");
-       wprintf("<div id=\"fix_scrollbar_bug\">"
+       wprintf("<FORM METHOD=\"POST\" action=\"submit_vcard\">\n");
+       wprintf("<div class=\"fix_scrollbar_bug\">"
                "<table border=0 width=100%% bgcolor=\"#ffffff\"><tr><td>\n");
 
        wprintf("<TABLE border=0><TR>"
@@ -214,9 +220,9 @@ void do_edit_vcard(long msgnum, char *partnum, char *return_to) {
 
        wprintf(_("Display name:"));
        wprintf("<br>"
-               "<INPUT TYPE=\"text\" NAME=\"displayname\" "
+               "<INPUT TYPE=\"text\" NAME=\"fullname\" "
                "VALUE=\"%s\" MAXLENGTH=\"40\"><br><br>\n",
-               displayname
+               fullname
        );
 
        wprintf(_("Title:"));
@@ -335,7 +341,9 @@ void do_edit_vcard(long msgnum, char *partnum, char *return_to) {
 }
 
 
-
+/**
+ * \brief commit the edits to the citadel server
+ */
 void edit_vcard(void) {
        long msgnum;
        char *partnum;
@@ -347,7 +355,9 @@ void edit_vcard(void) {
 
 
 
-
+/**
+ * \brief parse edited vcard from the browser
+ */
 void submit_vcard(void) {
        char buf[SIZ];
        int i;
@@ -375,7 +385,7 @@ void submit_vcard(void) {
                bstr("prefix"),
                bstr("suffix") );
        serv_printf("title:%s", bstr("title") );
-       serv_printf("fn:%s", bstr("displayname") );
+       serv_printf("fn:%s", bstr("fullname") );
        serv_printf("org:%s", bstr("org") );
        serv_printf("adr:%s;%s;%s;%s;%s;%s;%s",
                bstr("pobox"),
@@ -400,13 +410,17 @@ void submit_vcard(void) {
        serv_puts("end:vcard");
        serv_puts("000");
 
-       if (!strcmp(bstr("return_to"), "/select_user_to_edit")) {
+       if (!strcmp(bstr("return_to"), "select_user_to_edit")) {
                select_user_to_edit(NULL, NULL);
        }
-       else if (!strcmp(bstr("return_to"), "/do_welcome")) {
+       else if (!strcmp(bstr("return_to"), "do_welcome")) {
                do_welcome();
        }
        else {
                readloop("readnew");
        }
 }
+
+
+
+/*@}*/