cleanup(core,docs): drop m_on_boot() global weak function; it is useless now.

Easy API enforces default memhook (or, one can override it
by writing its own constructor to run before libmodule's easy api ones).

Signed-off-by: Federico Di Pierro <nierro92@gmail.com>

Author: FedeDP

Lib/core/main.c

@@ -7,10 +7,6 @@
  * Code related to main library ctor/dtor + main() symbol. *
  ***********************************************************/
 
-_public_ _m_ctor0_ _weak_ void m_on_boot(void) {
-    M_DEBUG("Booting libmodule.\n");
-}
-
 _public_ _weak_ void m_ctx_pre_loop(m_ctx_t *c, int argc, char *argv[]) {
     M_DEBUG("Pre-looping libmodule easy API.\n");
 }

Lib/core/public/module/mod_easy.h

@@ -8,16 +8,14 @@
 
 /*
  * ctors order:
- * 0) global m_on_boot(), useful to set your own memhook if desired
- * 1) each m_mod_on_boot() (only mod_easy API)
- * 2) each m_mod_ctor() (only mod_easy API)
+ * 0) each m_mod_on_boot() (only mod_easy API)
+ * 1) each m_mod_ctor() (only mod_easy API)
  *
  * dtors order:
  * 0) each m_mod_dtor() (only mod_easy API)
  */
-#define _m_ctor0_         __attribute__((constructor (110)))
-#define _m_ctor1_         __attribute__((constructor (113)))
-#define _m_ctor2_         __attribute__((constructor (114)))
+#define _m_ctor0_         __attribute__((constructor (113)))
+#define _m_ctor1_         __attribute__((constructor (114)))
 #define _m_dtor0_         __attribute__((destructor (111)))
 
 /* Simple macro to automatically manage module lifecycle and callbacks */
@@ -27,7 +25,7 @@
     static void m_mod_on_evt(m_mod_t *mod, const m_queue_t *const evts); \
     static void m_mod_on_stop(m_mod_t *mod); \
     static m_ctx_t *_m_ctx; \
-    static void _m_ctor2_ m_m_ctor(void) { \
+    static void _m_ctor1_ m_m_ctor(void) { \
         _m_ctx = m_ctx(); \
         if (!_m_ctx) { \
             m_ctx_register(M_CTX_DEFAULT, &_m_ctx, 0, NULL); \
@@ -38,4 +36,4 @@
     static void _m_dtor0_ m_mod_dtor(void) { \
         m_mem_unrefp((void **)&_m_ctx); \
     } \
-    static void _m_ctor1_ m_mod_on_boot(void)
+    static void _m_ctor0_ m_mod_on_boot(void)

TODO.md

@@ -14,9 +14,10 @@
 - - [ ] drop m_ctx_t param from funtion calls
 - - [x] drop libmodule_init() and deinit() constructors
 - - [x] move ctor defines into mod_easy.h
-- - [ ] Specify that m_set_memhook should be called before allocating any libmodule related resource (ie: m_on_boot() for mod_easy, or before allocating first ctx, when manually)
+- - [x] drop m_on_boot(); specify that mod_easy API force-uses malloc,calloc and free by default.
+- - [x] Specify that m_set_memhook should be called before allocating any libmodule related resource
 - [x] and just add an m_ctx() API that returns ctx associated with current thread
-- [x] store in ctx a `void **curr_mod` that points to the module whose callback is currently being processed, if any, or NULL; when NULL; we are outside a module callback, therefore we can return it; else, we must guarantee that module has permissions to access its ctx
+- [x] store in ctx a `curr_mod` that points to the module whose callback is currently being processed, if any, or NULL; when NULL; we are outside a module callback, therefore we can return it; else, we must guarantee that module has permissions to access its ctx
 - [ ] Downside: how could we guarantee that 2 ctx with same name do not exist? We cannot; is this a limitation, actually?
 
 #### DOC

docs/concepts/concepts.md

@@ -44,10 +44,9 @@ Ctor order is specified in each namespace doc.
 ### Memhook
 
 Moreover, libmodule allows users to override default memhook used, by calling `m_set_memhook()`.  
-This function must be called from `m_on_boot()` function, because it has to be called before any internal ctor is run, ie: before any allocation takes place.  
+This function must be called before any libmodule's allocation takes place, ie: before calling the first `m_ctx_register`.  
 A memhook is just a wrapper around 3 main memory related functions:  
 
 * `malloc`  
 * `calloc`  
 * `free`  
-

docs/core/core.md

@@ -14,23 +14,6 @@ For the sake of readiness, function params where an output value will be stored,
 
 > **All the libmodule core API returns an errno-style negative error code, where left unspecified.**
 
-## Constructors
-
-Libmodule makes heavy usage of gcc `__attribute__((constructor))` (and destructor) to inizialize itself.  
-The order is the following:
-
-**Ctors**  
-
-* `m_on_boot()`
-* internal `libmodule_init()`
-* each `m_mod_on_boot()` (only mod_easy API)
-* each `m_mod_ctor()` (only mod_easy API)
-
-**Dtors**  
-
-* each `m_mod_dtor()` (only mod_easy API)
-* internal `libmodule_deinit()`
-
 ## Memory
 
 ### Ref counted

docs/core/mod.md

@@ -3,5 +3,5 @@
 Mod API denotes libmodule interface functions to manage modules.  
 It can be found in `<module/mod.h>` header.  
 
-> **All the ctx API expects a non-NULL ctx handler**, except for ... functions.  
+> **All the mod API expects a non-NULL mod handler**, except for ... functions.