more docs

html/pubkey.php

@@ -1,4 +1,30 @@
 <?php
+/*! @file
+
+    @id $Id$
+
+    @see @ref apipubkey
+
+    @page api
+
+    @section apipubkey Get Public Key
+
+    API-call pubkey.php
+
+    Get the public key of a user.
+
+    @param user Name of the user to ge public key from.
+
+    @return json encoded value:
+     - @c null in case of error (user does not exist)
+     - @code
+       {
+         pubkey: 'armored public key string'
+       }
+       @endcode
+*/
+//       1         2         3         4         5         6         7         8
+// 45678901234567890123456789012345678901234567890123456789012345678901234567890
 try {
   require_once("usertable.php");
   $user = $db->real_escape_string($_REQUEST['user']);