[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] r28778 - in libmicrohttpd: doc/doxygen src/include
From: |
gnunet |
Subject: |
[GNUnet-SVN] r28778 - in libmicrohttpd: doc/doxygen src/include |
Date: |
Thu, 22 Aug 2013 09:01:16 +0200 |
Author: grothoff
Date: 2013-08-22 09:01:16 +0200 (Thu, 22 Aug 2013)
New Revision: 28778
Modified:
libmicrohttpd/doc/doxygen/libmicrohttpd.doxy
libmicrohttpd/src/include/microhttpd.h
Log:
-more doxygen improvements
Modified: libmicrohttpd/doc/doxygen/libmicrohttpd.doxy
===================================================================
--- libmicrohttpd/doc/doxygen/libmicrohttpd.doxy 2013-08-22 06:40:11 UTC
(rev 28777)
+++ libmicrohttpd/doc/doxygen/libmicrohttpd.doxy 2013-08-22 07:01:16 UTC
(rev 28778)
@@ -98,7 +98,7 @@
RECURSIVE = YES
EXCLUDE =
EXCLUDE_SYMLINKS = NO
-EXCLUDE_PATTERNS = */test_* */.svn/* */perf_*
+EXCLUDE_PATTERNS = */test_* */.svn/* */perf_* */tls_test_* */examples/*
*/testcurl/* */testspdy/* */testzzuf/* */plibc/* */symbian/* MHD_config.h
EXCLUDE_SYMBOLS = MHD_DLOG
EXAMPLE_PATH =
EXAMPLE_PATTERNS = *
Modified: libmicrohttpd/src/include/microhttpd.h
===================================================================
--- libmicrohttpd/src/include/microhttpd.h 2013-08-22 06:40:11 UTC (rev
28777)
+++ libmicrohttpd/src/include/microhttpd.h 2013-08-22 07:01:16 UTC (rev
28778)
@@ -69,11 +69,18 @@
* failing) to include the right headers.
*
* @defgroup event event-loop control
+ * MHD API to start and stop the HTTP server and manage the event loop.
* @defgroup response generation of responses
+ * MHD API used to generate responses.
* @defgroup request handling of requests
+ * MHD API used to access information about requests.
* @defgroup authentication HTTP authentication
- * @defgroup logging logging and error handling
+ * MHD API related to basic and digest HTTP authentication.
+ * @defgroup logging logging
+ * MHD API to mange logging and error handling
* @defgroup specialized misc. specialized functions
+ * This group includes functions that do not fit into any particular
+ * category and that are rarely used.
*/
#ifndef MHD_MICROHTTPD_H
@@ -175,6 +182,7 @@
/**
* @defgroup httpcode HTTP response codes.
+ * These are the status codes defined for HTTP responses.
* @{
*/
#define MHD_HTTP_CONTINUE 100
@@ -250,6 +258,7 @@
/**
* @defgroup headers HTTP headers
+ * These are the standard headers found in HTTP requests and responses.
* @{
*/
/* See also: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html */
@@ -308,8 +317,9 @@
/** @} */ /* end of group headers */
/**
- * @defgroup versions HTTP versions (used to match against the first line of
the
- * HTTP header as well as in the response code).
+ * @defgroup versions HTTP versions
+ * These strings should be used to match against the first line of the
+ * HTTP header.
* @{
*/
#define MHD_HTTP_VERSION_1_0 "HTTP/1.0"
@@ -319,6 +329,7 @@
/**
* @defgroup methods HTTP methods
+ * Standard HTTP methods (as strings).
* @{
*/
#define MHD_HTTP_METHOD_CONNECT "CONNECT"
@@ -333,8 +344,8 @@
/** @} */ /* end of group methods */
/**
- * @defgroup postenc HTTP POST encodings, see also
- * http://www.w3.org/TR/html4/interact/forms.html#h-17.13.4
+ * @defgroup postenc HTTP POST encodings
+ * See also: http://www.w3.org/TR/html4/interact/forms.html#h-17.13.4
* @{
*/
#define MHD_HTTP_POST_ENCODING_FORM_URLENCODED
"application/x-www-form-urlencoded"
@@ -344,39 +355,41 @@
/**
- * Handle for the daemon (listening on a socket for HTTP traffic).
+ * @brief Handle for the daemon (listening on a socket for HTTP traffic).
* @ingroup event
*/
struct MHD_Daemon;
/**
- * Handle for a connection / HTTP request. With HTTP/1.1, multiple
- * requests can be run over the same connection. However, MHD will
- * only show one request per TCP connection to the client at any given
- * time.
+ * @brief Handle for a connection / HTTP request.
+ *
+ * With HTTP/1.1, multiple requests can be run over the same
+ * connection. However, MHD will only show one request per TCP
+ * connection to the client at any given time.
* @ingroup request
*/
struct MHD_Connection;
/**
- * Handle for a response.
+ * @brief Handle for a response.
* @ingroup response
*/
struct MHD_Response;
/**
- * Handle for POST processing.
+ * @brief Handle for POST processing.
* @ingroup response
*/
struct MHD_PostProcessor;
/**
- * Options for the MHD daemon. Note that if neither
- * #MHD_USE_THREAD_PER_CONNECTION nor #MHD_USE_SELECT_INTERNALLY is
- * used, the client wants control over the process and will call the
- * appropriate microhttpd callbacks.
+ * @brief Flags for the `struct MHD_Daemon`.
*
+ * Note that if neither #MHD_USE_THREAD_PER_CONNECTION nor
+ * #MHD_USE_SELECT_INTERNALLY is used, the client wants control over
+ * the process and will call the appropriate microhttpd callbacks.
+ *
* Starting the daemon may also fail if a particular option is not
* implemented or not supported on the target platform (i.e. no
* support for SSL, threads or IPv6).
@@ -520,7 +533,9 @@
/**
- * MHD options. Passed in the varargs portion of #MHD_start_daemon.
+ * @brief MHD options.
+ *
+ * Passed in the varargs portion of #MHD_start_daemon.
*/
enum MHD_OPTION
{
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] r28778 - in libmicrohttpd: doc/doxygen src/include,
gnunet <=