[libmicrohttpd] 222/335: this_API_is_TERRIBLE: even more

[gnunet]

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

grothoff pushed a commit to tag stf-m2
in repository libmicrohttpd.

commit e0206d1972c64ab6761fa66d69a099909a034e35
Author: Evgeny Grin (Karlson2k) <k2k@narod.ru>
AuthorDate: Fri Jun 21 17:29:41 2024 +0200

    this_API_is_TERRIBLE: even more
---
 src/include/this_API_is_TERRIBLE.txt | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/include/this_API_is_TERRIBLE.txt 
b/src/include/this_API_is_TERRIBLE.txt
index 6fc52db4..da68df36 100644
--- a/src/include/this_API_is_TERRIBLE.txt
+++ b/src/include/this_API_is_TERRIBLE.txt
@@ -34,6 +34,12 @@
 -- Having both MHD_D_O_XXX and (two times of each) MHD_D_OPTION_XXX is
    confusion and not obvious. Even you was confused with similar names and
    used MHD_D_OPTION_XXX as switch values, while it must be MHD_D_O_XXX.
+-- Try to work with simple things: find how to set "epoll" syscall; find how
+   to enable internal thread pool.  The header is written in the way that
+   is very inconvenient to find needed options and the way how to set them.
+-- The API should be self-documenting. This is main goal defined everywhere.
+   This API is **NOT** self-documenting. Three levels of macros for basic
+   things, like "work mode" is not acceptable!
 
 - This design is less secure by nature. The sizes of arrays or memory
   allocations cannot be checked by compilers (like 

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