more docs

html/send.php

@@ -1,4 +1,30 @@
 <?php
+/*! @file
+
+    @id $Id$
+
+    @see @ref apisend
+
+    @page api
+
+    @section apisend Send Message To Server
+
+    API-call send.php
+
+    Send a message to the server. Sever checks if user exists and has
+    a valid public key. More test could be added later.
+
+    @param user The name of the user that send the message.
+
+    @param msg The armored signed and encrypted message. There is a
+               limit of 100000 bytes for the message.
+
+    @return
+      - success() if the message has been stored successfully
+      - error() in case of any error
+*/
+//       1         2         3         4         5         6         7         8
+// 45678901234567890123456789012345678901234567890123456789012345678901234567890
 try {
   require_once("usertable.php");
   $user = $db->real_escape_string($_REQUEST['user']);