[GNUnet-SVN] r14041 - in gnunet/src: dht fs include monkey monkey/seaspider

[gnunet]

Author: wachs
Date: 2010-12-23 10:40:16 +0100 (Thu, 23 Dec 2010)
New Revision: 14041

Modified:
   gnunet/src/dht/gnunet-service-dht.c
   gnunet/src/fs/fs_download.c
   gnunet/src/include/gnunet_monkey_edb.h
   gnunet/src/monkey/edb_api.c
   gnunet/src/monkey/gdbmi_alloc.c
   gnunet/src/monkey/gdbmi_breakpoint.c
   gnunet/src/monkey/gdbmi_connect.c
   gnunet/src/monkey/gdbmi_data_man.c
   gnunet/src/monkey/gdbmi_get_free_pty.c
   gnunet/src/monkey/gdbmi_misc.c
   gnunet/src/monkey/gdbmi_prg_control.c
   gnunet/src/monkey/gdbmi_stack_man.c
   gnunet/src/monkey/gdbmi_target_man.c
   gnunet/src/monkey/gdbmi_thread.c
   gnunet/src/monkey/gdbmi_var_obj.c
   gnunet/src/monkey/seaspider/SeaspiderTest.c
Log:
doxygen


Modified: gnunet/src/dht/gnunet-service-dht.c
===================================================================
--- gnunet/src/dht/gnunet-service-dht.c 2010-12-23 09:39:58 UTC (rev 14040)
+++ gnunet/src/dht/gnunet-service-dht.c 2010-12-23 09:40:16 UTC (rev 14041)
@@ -1951,6 +1951,7 @@
  * @param client the client to send the reply to
  * @param message the encapsulated message to send
  * @param uid the unique identifier of this request
+ * @param key key
  */
 static void
 send_reply_to_client (struct ClientList *client,
@@ -4602,6 +4603,7 @@
  * Core handler for p2p route requests.
  *
  * @param cls closure
+ * @param message message
  * @param peer peer identity this notification is about
  * @param atsi performance data
  *
@@ -4705,6 +4707,7 @@
  * Core handler for p2p route results.
  *
  * @param cls closure
+ * @param message message
  * @param peer peer identity this notification is about
  * @param atsi performance data
  *

Modified: gnunet/src/fs/fs_download.c
===================================================================
--- gnunet/src/fs/fs_download.c 2010-12-23 09:39:58 UTC (rev 14040)
+++ gnunet/src/fs/fs_download.c 2010-12-23 09:40:16 UTC (rev 14041)
@@ -534,6 +534,7 @@
  * @param cls closure
  * @param query the query for the block (key for lookup in the datastore)
  * @param offset offset of the block
+ * @param depth depth
  * @param type type of the block (IBLOCK or DBLOCK)
  * @param block the (encrypted) block
  * @param block_size size of block (in bytes)

Modified: gnunet/src/include/gnunet_monkey_edb.h
===================================================================
--- gnunet/src/include/gnunet_monkey_edb.h      2010-12-23 09:39:58 UTC (rev 
14040)
+++ gnunet/src/include/gnunet_monkey_edb.h      2010-12-23 09:40:16 UTC (rev 
14041)
@@ -50,8 +50,7 @@
 /**
  * Disconnect from Database, and cleanup resources
  *
- * @param cfg configuration to use (used to know the path of the .db file).
- * @param service service that *this* process is implementing/providing, can 
be NULL
+ * @param context context
  * @return GNUNET_OK on success, GNUNET_NO on failure
  */
 int GNUNET_MONKEY_EDB_disconnect (struct GNUNET_MONKEY_EDB_Context *context);

Modified: gnunet/src/monkey/edb_api.c
===================================================================
--- gnunet/src/monkey/edb_api.c 2010-12-23 09:39:58 UTC (rev 14040)
+++ gnunet/src/monkey/edb_api.c 2010-12-23 09:40:16 UTC (rev 14041)
@@ -58,8 +58,7 @@
 /**
  * Disconnect from Database, and cleanup resources
  *
- * @param cfg configuration to use (used to know the path of the .db file).
- * @param service service that *this* process is implementing/providing, can 
be NULL
+ * @param context context
  * @return GNUNET_OK on success, GNUNET_NO on failure
  */
 int

Modified: gnunet/src/monkey/gdbmi_alloc.c
===================================================================
--- gnunet/src/monkey/gdbmi_alloc.c     2010-12-23 09:39:58 UTC (rev 14040)
+++ gnunet/src/monkey/gdbmi_alloc.c     2010-12-23 09:40:16 UTC (rev 14041)
@@ -6,7 +6,7 @@
   Module: Allocator.
   Comments:
   Most alloc/free routines are here. Free routines must accept NULL
-pointers. Alloc functions must set address@hidden
+pointers. Alloc functions must set mi_error.  @<p>
   
 ***************************************************************************/
 

Modified: gnunet/src/monkey/gdbmi_breakpoint.c
===================================================================
--- gnunet/src/monkey/gdbmi_breakpoint.c        2010-12-23 09:39:58 UTC (rev 
14040)
+++ gnunet/src/monkey/gdbmi_breakpoint.c        2010-12-23 09:40:16 UTC (rev 
14041)
@@ -5,8 +5,8 @@
 
   Module: Breakpoint table commands.
   Comments:
-  GDB/MI commands for the "Breakpoint Table Commands" address@hidden
-
+  GDB/MI commands for the "Breakpoint Table Commands" section.
+   @<p>
 @<pre>
 gdb command:          Implemented?
 
@@ -22,7 +22,7 @@
 @</pre>
 
 (*) I think the program should keep track of the breakpoints, so it will
-be implemented when I have more address@hidden
+be implemented when I have more time.  @<p>
 
 ***************************************************************************/
 

Modified: gnunet/src/monkey/gdbmi_connect.c
===================================================================
--- gnunet/src/monkey/gdbmi_connect.c   2010-12-23 09:39:58 UTC (rev 14040)
+++ gnunet/src/monkey/gdbmi_connect.c   2010-12-23 09:40:16 UTC (rev 14041)
@@ -6,7 +6,8 @@
   Module: Connect.
   Comments:
   This module handles the dialog with gdb, including starting and stopping
address@hidden
+gdb.
+  @<p>
 
 GDB Bug workaround for "file -readnow": I tried to workaround a bug using
 it but looks like this option also have bugs!!!! so I have to use the
@@ -441,7 +442,7 @@
 /**[txh]********************************************************************
 
   Description:
-  Close connection. You should ask gdb to quit first @x{gmi_gdb_exit}.
+  Close connection. You should ask gdb to quit first gmi_gdb_exit.
   
 ***************************************************************************/
 
@@ -705,7 +706,7 @@
   Description:
   Opens a new xterm to be used by the child process to debug.
   
-  Return: A new mi_aux_term structure, you can use @x{gmi_end_aux_term} to
+  Return: A new mi_aux_term structure, you can use gmi_end_aux_term to
 release it.
   
 ***************************************************************************/
@@ -853,7 +854,7 @@
 /**[txh]********************************************************************
 
   Description:
-  Dis/Enables the @var{wa} workaround for a bug in gdb.
+  Dis/Enables the workaround for a bug in gdb.
 
 ***************************************************************************/
 
@@ -870,7 +871,7 @@
 /**[txh]********************************************************************
 
   Description:
-  Finds if the @var{wa} workaround for a bug in gdb is enabled.
+  Finds if the workaround for a bug in gdb is enabled.
   
   Return: !=0 if enabled.
   

Modified: gnunet/src/monkey/gdbmi_data_man.c
===================================================================
--- gnunet/src/monkey/gdbmi_data_man.c  2010-12-23 09:39:58 UTC (rev 14040)
+++ gnunet/src/monkey/gdbmi_data_man.c  2010-12-23 09:40:16 UTC (rev 14041)
@@ -5,8 +5,10 @@
 
   Module: Data manipulation.
   Comments:
-  GDB/MI commands for the "Data manipulation" address@hidden
+  GDB/MI commands for the "Data manipulation" section.
 
+  @<p>
+
 @<pre>
 gdb command:                       Implemented?
 
@@ -26,11 +28,11 @@
 -environment-path                  No
 @</pre>
 
-Notes:@p
+Notes:  @<p>
 
 1) -display* aren't implemented. You can use CLI command display, but the
 results are sent to the console. So it looks like the best is to manually
-use -data-evaluate-expression to emulate address@hidden
+use -data-evaluate-expression to emulate it.  @<p>
 
 2) GDB bug mi/1770: Affects gdb<=6.2, when you ask for the names of the
 registers you get it plus the name of the "pseudo-registers", but if you

Modified: gnunet/src/monkey/gdbmi_get_free_pty.c
===================================================================
--- gnunet/src/monkey/gdbmi_get_free_pty.c      2010-12-23 09:39:58 UTC (rev 
14040)
+++ gnunet/src/monkey/gdbmi_get_free_pty.c      2010-12-23 09:40:16 UTC (rev 
14041)
@@ -86,7 +86,7 @@
   Description:
   Look for a free and usable pseudo terminal to be used by the child.
   
-  Return: A new mi_pty structure, you can use @x{gmi_end_pty} to
+  Return: A new mi_pty structure, you can use gmi_end_pty to
 release it.
   
 ***************************************************************************/

Modified: gnunet/src/monkey/gdbmi_misc.c
===================================================================
--- gnunet/src/monkey/gdbmi_misc.c      2010-12-23 09:39:58 UTC (rev 14040)
+++ gnunet/src/monkey/gdbmi_misc.c      2010-12-23 09:40:16 UTC (rev 14041)
@@ -5,7 +5,7 @@
 
   Module: Miscellaneous commands.
   Comments:
-  GDB/MI commands for the "Miscellaneous Commands" address@hidden
+  GDB/MI commands for the "Miscellaneous Commands" section.  @<p>
 
 @<pre>
 gdb command:       Implemented?

Modified: gnunet/src/monkey/gdbmi_prg_control.c
===================================================================
--- gnunet/src/monkey/gdbmi_prg_control.c       2010-12-23 09:39:58 UTC (rev 
14040)
+++ gnunet/src/monkey/gdbmi_prg_control.c       2010-12-23 09:40:16 UTC (rev 
14041)
@@ -5,7 +5,7 @@
 
   Module: Program control.
   Comments:
-  GDB/MI commands for the "Program Control" address@hidden
+  GDB/MI commands for the "Program Control" section.  @<p>
 
 @<pre>
 gdb command:                   Implemented?
@@ -33,7 +33,7 @@
 @</pre>
 
 (*)  gmi_exec_kill implements it, but you should ensure that
-gmi_gdb_set("confirm","off") was address@hidden
+gmi_gdb_set("confirm","off") was called.  @<p>
 
 GDB Bug workaround for -file-exec-and-symbols and -file-symbol-file: This
 is complex, but a real bug. When you set a breakpoint you never know the

Modified: gnunet/src/monkey/gdbmi_stack_man.c
===================================================================
--- gnunet/src/monkey/gdbmi_stack_man.c 2010-12-23 09:39:58 UTC (rev 14040)
+++ gnunet/src/monkey/gdbmi_stack_man.c 2010-12-23 09:40:16 UTC (rev 14041)
@@ -5,7 +5,7 @@
 
   Module: Stack manipulation.
   Comments:
-  GDB/MI commands for the "Stack Manipulation" address@hidden
+  GDB/MI commands for the "Stack Manipulation" section.  @<p>
 
 @<pre>
 gdb command:              Implemented?
@@ -84,8 +84,8 @@
 /**[txh]********************************************************************
 
   Description: 
-  List of frames. Arguments aren't filled. Only the frames in the @var{from}
- - @var{to} range are returned.
+  List of frames. Arguments aren't filled. Only the frames in the from
+ - to range are returned.
   
   Command: -stack-list-frames
   Return:  A new list of mi_frames or NULL on error.
@@ -101,7 +101,7 @@
 /**[txh]********************************************************************
 
   Description:
-  List arguments. Only @var{level} and @var{args} filled.
+  List arguments. Only level and args filled.
   
   Command: -stack-list-arguments
   Return:  A new list of mi_frames or NULL on error.
@@ -117,8 +117,8 @@
 /**[txh]********************************************************************
 
   Description:
-  List arguments. Only @var{level} and @var{args} filled. Only for the
-frames in the @var{from} - @var{to} range.
+  List arguments. Only level and args filled. Only for the
+frames in the from - to range.
   
   Command: -stack-list-arguments
   Return:  A new list of mi_frames or NULL on error.

Modified: gnunet/src/monkey/gdbmi_target_man.c
===================================================================
--- gnunet/src/monkey/gdbmi_target_man.c        2010-12-23 09:39:58 UTC (rev 
14040)
+++ gnunet/src/monkey/gdbmi_target_man.c        2010-12-23 09:40:16 UTC (rev 
14041)
@@ -5,7 +5,7 @@
 
   Module: Target manipulation.
   Comments:
-  GDB/MI commands for the "Target Manipulation" address@hidden
+  GDB/MI commands for the "Target Manipulation" section.  @<p>
 
 @<pre>
 -target-attach                  Yes (implemented using attach)

Modified: gnunet/src/monkey/gdbmi_thread.c
===================================================================
--- gnunet/src/monkey/gdbmi_thread.c    2010-12-23 09:39:58 UTC (rev 14040)
+++ gnunet/src/monkey/gdbmi_thread.c    2010-12-23 09:40:16 UTC (rev 14041)
@@ -5,7 +5,7 @@
 
   Module: Thread commands.
   Comments:
-  GDB/MI commands for the "Thread Commands" address@hidden
+  GDB/MI commands for the "Thread Commands" section.  @<p>
 
 @<pre>
 gdb command:              Implemented?

Modified: gnunet/src/monkey/gdbmi_var_obj.c
===================================================================
--- gnunet/src/monkey/gdbmi_var_obj.c   2010-12-23 09:39:58 UTC (rev 14040)
+++ gnunet/src/monkey/gdbmi_var_obj.c   2010-12-23 09:40:16 UTC (rev 14041)
@@ -5,7 +5,8 @@
 
   Module: Variable objects.
   Comments:
-  GDB/MI commands for the "Variable Objects" address@hidden
+  GDB/MI commands for the "Variable Objects" section.
+    @<p>
 
 @<pre>
 gdb command:              Imp? Description:
@@ -23,14 +24,15 @@
 -var-update               Yes* update the variable and its children
 @</pre>
 
-Notes:@p
+Notes:  @<p>
 1) I suggest letting gdb to choose the names for the address@hidden
 2) -var-list-children supports an optional "show values" argument in MI v2.
 It isn't address@hidden
address@hidden
 
-* MI v1 and v2 result formats address@hidden
+  @<p>
 
+* MI v1 and v2 result formats supported.  @<p>
+
 ***************************************************************************/
 
 #include "gdbmi.h"
@@ -113,7 +115,7 @@
 /**[txh]********************************************************************
 
   Description:
-  Create a variable object. I recommend using @x{gmi_var_create} and letting
+  Create a variable object. I recommend using gmi_var_create and letting
 gdb choose the names.
 
   Command: -var-create
@@ -131,7 +133,7 @@
 
   Description:
   Create a variable object. The name is selected by gdb. Alternative:
address@hidden
+  gmi_full_var_create.
 
   Command: -var-create [auto name]
   Return: A new mi_gvar strcture or NULL on error.
@@ -292,7 +294,7 @@
 updated.
 
   Command: -var-update
-  Return: !=0 OK. The @var{changed} list contains the list of changed vars.
+  Return: !=0 OK. The changed list contains the list of changed vars.
   
 ***************************************************************************/
 
@@ -305,7 +307,7 @@
 /**[txh]********************************************************************
 
   Description:
-  Change variable. The new value replaces the @var{value} field.
+  Change variable. The new value replaces the value field.
 
   Command: -var-assign
   Return: !=0 OK

Modified: gnunet/src/monkey/seaspider/SeaspiderTest.c
===================================================================
--- gnunet/src/monkey/seaspider/SeaspiderTest.c 2010-12-23 09:39:58 UTC (rev 
14040)
+++ gnunet/src/monkey/seaspider/SeaspiderTest.c 2010-12-23 09:40:16 UTC (rev 
14041)
@@ -1,5 +1,5 @@
 /**
- * @file seaspider/SeaspiderTest.c
+ * @file src/monkey/seaspider/SeaspiderTest.c
  * @brief C file to test Seaspider's parsing
  */