[libmicrohttpd2] branch master updated: migration doc start

[Admin]

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

grothoff pushed a commit to branch master
in repository libmicrohttpd2.

The following commit(s) were added to refs/heads/master by this push:
     new 898504a  migration doc start
898504a is described below

commit 898504af1d7327061f70250c5def6c52720531f6
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Thu Feb 27 00:28:27 2025 +0100

    migration doc start
---
 contrib/mhd2.m4          | 15 +++++++-------
 doc/manual/migration.inc | 53 ++++++++++++++++++++++++++++++++++++++++--------
 2 files changed, 53 insertions(+), 15 deletions(-)

diff --git a/contrib/mhd2.m4 b/contrib/mhd2.m4
index 2f77522..5f9be3d 100644
--- a/contrib/mhd2.m4
+++ b/contrib/mhd2.m4
@@ -27,7 +27,7 @@ dnl This uses AX_COMPARE_VERSION to do the job.
 dnl It sets shell var mhd_cv_version, as well.
 dnl
 AC_DEFUN([MHD2_VERSION_AT_LEAST],
-[AC_CACHE_CHECK([libmicrohttpd2 version],[mhd_cv_version],
+ [AC_CACHE_CHECK([libmicrohttpd2 version],[mhd2_cv_version],
  [AC_LINK_IFELSE([AC_LANG_PROGRAM([[
   #include <stdio.h>
   #include <microhttpd2.h>
@@ -40,10 +40,11 @@ AC_DEFUN([MHD2_VERSION_AT_LEAST],
 ]])],
   [mhd2_cv_version=$(./conftest)],
   [mhd2_cv_version=0])])
-AX_COMPARE_VERSION([$mhd_cv_version],[ge],[$1],,
-  [AC_MSG_ERROR([[
-***
-*** You need libmicrohttpd2 >= $1 to build this program.
-*** ]])])])
-
+AX_COMPARE_VERSION([$mhd2_cv_version],[ge],[$1],
+  [libmhd2=1],
+  [libmhd2=0])
+AM_CONDITIONAL([HAVE_MHD2], [test "x$libmhd2" = "x1"])
+AC_DEFINE_UNQUOTED([HAVE_MHD2], [$libmhd2],
+                   [Defined to 1 if libmicrohttpd2 is available])
+])
 # mhd2.m4 ends here
diff --git a/doc/manual/migration.inc b/doc/manual/migration.inc
index 9412a34..0670676 100644
--- a/doc/manual/migration.inc
+++ b/doc/manual/migration.inc
@@ -55,18 +55,19 @@ AC_ARG_WITH([microhttpd2],
             [AC_MSG_RESULT([not given])
              with_microhttpd2=yes])
 AS_CASE([$with_microhttpd2],
-        [yes], [],
-        [no], [AC_MSG_ERROR([--with-microhttpd2 is required])],
+        [yes],,
+        [no],,
         [LDFLAGS="-L$with_microhttpd2/lib $LDFLAGS"
          CPPFLAGS="-I$with_microhttpd2/include $CPPFLAGS"])
+# This will set HAVE_MHD2 as above for conditional compilation
 MHD2_VERSION_AT_LEAST([2.0.0])
 @end verbatim
 
-The @code{MHD2_VERSION_AT_LEAST} is an M4 macro available
-as part of the GNU libmicrohttpd2 library which implements
-a test for the specific MHD version. You may need to copy
-the M4 file into your @code{m4/} directory so that
-GNU autoconf can find it.
+The @code{MHD2_VERSION_AT_LEAST} is an M4 macro available in the
+@code{mhd2.m4} file as part of the GNU libmicrohttpd2 library which
+implements a test for the specific MHD version. You may need to copy
+the @code{mhd2.m4} file into your @code{m4/} directory so that GNU
+autoconf can find it.
 
 @cindex meson
 
@@ -83,6 +84,10 @@ endif
 Adjust the @code{required} argument to
 @code{true} if MHD2 is a mandatory dependency.
 
+Naturally, there are various variations of the above that
+could be used to detect MHD2, so these are merely examples
+to get started.
+
 
 @node libmicrohttpd-include
 @section Changes to includes
@@ -107,5 +112,37 @@ could be an opportunity to review whether some other 
includes
 are still necessary and possibly remove them.
 
 
-@node libmicrohttpd-start-daemon
+@node libmicrohttpd-migrate-start-daemon
 @section Changes to @code{MHD_start_daemon()}
+
+@c FIXME: write!
+
+
+There are a few very minor changes to be made to the related API calls
+to quiesce and destroy the daemon: the functions
+@code{MHD_stop_daemon()} and @code{MHD_quiesce_daemon()} were renamed
+to @code{MHD_daemon_destroy()} and @code{MHD_daemon_quiesce()}
+respectively. Nevertheless, the behavior is completely unchanged,
+so applications only need to rename the calls.
+
+@node libmicrohttpd-migrate-loop
+@section Migrating the event loop
+
+@c FIXME: write!
+
+
+@node libmicrohttpd-migrate-request-handling
+@section Migrating request handling
+
+@c FIXME: write!
+
+
+@node libmicrohttpd-migrate-response-generation
+@section Migrating response generation
+
+@c FIXME: write!
+
+@node libmicrohttpd-migrate-post-processor
+@section Migrating post processing
+
+@c FIXME: write!

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