[libmicrohttpd] branch master updated: MHD_free(): updated doxy

[gnunet]

This is an automated email from the git hooks/post-receive script.

karlson2k pushed a commit to branch master
in repository libmicrohttpd.

The following commit(s) were added to refs/heads/master by this push:
     new 84619630 MHD_free(): updated doxy
84619630 is described below

commit 846196300f82fd1b5f5bac4b6a4ebd9540a4706d
Author: Evgeny Grin (Karlson2k) <k2k@narod.ru>
AuthorDate: Fri Jun 10 11:17:12 2022 +0300

    MHD_free(): updated doxy
---
 src/include/microhttpd.h | 28 ++++++++++++++++------------
 src/microhttpd/daemon.c  | 15 ++++++++++-----
 2 files changed, 26 insertions(+), 17 deletions(-)

diff --git a/src/include/microhttpd.h b/src/include/microhttpd.h
index 4936e912..5ddd60da 100644
--- a/src/include/microhttpd.h
+++ b/src/include/microhttpd.h
@@ -2925,6 +2925,22 @@ MHD_get_timeout (struct MHD_Daemon *daemon,
                  MHD_UNSIGNED_LONG_LONG *timeout);
 
 
+/**
+ * Free the memory allocated by MHD.
+ *
+ * If any MHD function explicitly mentions that returned pointer must be
+ * freed by this function, then no other method must be used to free
+ * the memory.
+ *
+ * @param ptr the pointer to free.
+ * @sa #MHD_digest_auth_get_username(), 
#MHD_basic_auth_get_username_password3()
+ * @sa #MHD_basic_auth_get_username_password()
+ * @note Available since #MHD_VERSION 0x00095600
+ * @ingroup specialized
+ */
+_MHD_EXTERN void
+MHD_free (void *ptr);
+
 /**
  * Obtain timeout value for external polling function for this daemon.
  *
@@ -4329,18 +4345,6 @@ _MHD_EXTERN char *
 MHD_digest_auth_get_username (struct MHD_Connection *connection);
 
 
-/**
- * Free the memory given by @a ptr. Calls "free(ptr)".  This function
- * should be used to free the username returned by
- * #MHD_digest_auth_get_username().
- * @note Available since #MHD_VERSION 0x00095600
- *
- * @param ptr pointer to free.
- */
-_MHD_EXTERN void
-MHD_free (void *ptr);
-
-
 /**
  * Which digest algorithm should MHD use for HTTP digest authentication?
  */
diff --git a/src/microhttpd/daemon.c b/src/microhttpd/daemon.c
index 013c84c5..1e591ce3 100644
--- a/src/microhttpd/daemon.c
+++ b/src/microhttpd/daemon.c
@@ -204,12 +204,17 @@ MHD_default_logger_ (void *cls,
 
 
 /**
- * Free the memory given by @a ptr. Calls "free(ptr)".  This function
- * should be used to free the username returned by
- * #MHD_digest_auth_get_username().
- * @note Available since #MHD_VERSION 0x00095600
+ * Free the memory allocated by MHD.
+ *
+ * If any MHD function explicitly mentions that returned pointer must be
+ * freed by this function, then no other method must be used to free
+ * the memory.
  *
- * @param ptr pointer to free.
+ * @param ptr the pointer to free.
+ * @sa #MHD_digest_auth_get_username(), 
#MHD_basic_auth_get_username_password3()
+ * @sa #MHD_basic_auth_get_username_password()
+ * @note Available since #MHD_VERSION 0x00095600
+ * @ingroup specialized
  */
 _MHD_EXTERN void
 MHD_free (void *ptr)

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.