-First pass through GNUnet common library

3 files changed, 0 insertions, 69 deletions

diff --git a/src/util/common_allocation.c b/src/util/common_allocation.c
index f48f87167..a43ac3865 100644
--- a/src/util/common_allocation.c
+++ b/src/util/common_allocation.c
@@ -155,17 +155,6 @@ GNUNET_xnew_array_3d_ (size_t n,
 }
 
 
-/**
- * Allocate and initialize memory. Checks the return value, aborts if no more
- * memory is available.  Don't use #GNUNET_xmemdup_() directly. Use the
- * GNUNET_memdup() macro.
- *
- * @param buf buffer to initialize from (must contain size bytes)
- * @param size number of bytes to allocate
- * @param filename where is this call being made (for debugging)
- * @param linenumber line where this call is being made (for debugging)
- * @return allocated memory, never NULL
- */
 void *
 GNUNET_xmemdup_ (const void *buf,
                  size_t size,
@@ -476,12 +465,6 @@ GNUNET_snprintf (char *buf, size_t size, const char *format, ...)
 }
 
 
-/**
- * Create a copy of the given message.
- *
- * @param msg message to copy
- * @return duplicate of the message
- */
 struct GNUNET_MessageHeader *
 GNUNET_copy_message (const struct GNUNET_MessageHeader *msg)
 {
diff --git a/src/util/common_endian.c b/src/util/common_endian.c
index d69cc1da5..ce70f91da 100644
--- a/src/util/common_endian.c
+++ b/src/util/common_endian.c
@@ -65,11 +65,6 @@ GNUNET_ntohll (uint64_t n)
 #endif
 
 
-/**
- * Convert double to network-byte-order.
- * @param d the value in network byte order
- * @return the same value in host byte order
- */
 double
 GNUNET_hton_double (double d)
 {
@@ -83,11 +78,6 @@ GNUNET_hton_double (double d)
 }
 
 
-/**
- * Convert double to host-byte-order
- * @param d the value in network byte order
- * @return the same value in host byte order
- */
 double
 GNUNET_ntoh_double (double d)
 {
diff --git a/src/util/common_logging.c b/src/util/common_logging.c
index b07f3fc0b..27d9ca3ce 100644
--- a/src/util/common_logging.c
+++ b/src/util/common_logging.c
@@ -768,15 +768,6 @@ GNUNET_log_setup (const char *comp,
 }
 
 
-/**
- * Add a custom logger. Note that installing any custom logger
- * will disable the standard logger.  When multiple custom loggers
- * are installed, all will be called.  The standard logger will
- * only be used if no custom loggers are present.
- *
- * @param logger log function
- * @param logger_cls closure for @a logger
- */
 void
 GNUNET_logger_add (GNUNET_Logger logger, void *logger_cls)
 {
@@ -790,12 +781,6 @@ GNUNET_logger_add (GNUNET_Logger logger, void *logger_cls)
 }
 
 
-/**
- * Remove a custom logger.
- *
- * @param logger log function
- * @param logger_cls closure for @a logger
- */
 void
 GNUNET_logger_remove (GNUNET_Logger logger, void *logger_cls)
 {
@@ -936,12 +921,6 @@ flush_bulk (const char *datestr)
 }
 
 
-/**
- * Ignore the next n calls to the log function.
- *
- * @param n number of log calls to ignore (could be negative)
- * @param check_reset #GNUNET_YES to assert that the log skip counter is currently zero
- */
 void
 GNUNET_log_skip (int n, int check_reset)
 {
@@ -1118,12 +1097,6 @@ GNUNET_log_from_nocheck (enum GNUNET_ErrorType kind,
 }
 
 
-/**
- * Convert error type to string.
- *
- * @param kind type to convert
- * @return string corresponding to the type
- */
 const char *
 GNUNET_error_type_to_string (enum GNUNET_ErrorType kind)
 {
@@ -1470,13 +1443,6 @@ GNUNET_a2s (const struct sockaddr *addr, socklen_t addrlen)
 }
 
 
-/**
- * Log error message about missing configuration option.
- *
- * @param kind log level
- * @param section section with missing option
- * @param option name of missing option
- */
 void
 GNUNET_log_config_missing (enum GNUNET_ErrorType kind,
                            const char *section,
@@ -1490,14 +1456,6 @@ GNUNET_log_config_missing (enum GNUNET_ErrorType kind,
 }
 
 
-/**
- * Log error message about invalid configuration option value.
- *
- * @param kind log level
- * @param section section with invalid option
- * @param option name of invalid option
- * @param required what is required that is invalid about the option
- */
 void
 GNUNET_log_config_invalid (enum GNUNET_ErrorType kind,
                            const char *section,