Cleaned up some out of date comments in examples.

Samples/Cpp/doggo.cpp

@@ -4,61 +4,28 @@
 
 static void receive_sleeping(const msg_t *msg, const void *userdata);
 
-/* 
- * Declare and automagically initialize 
- * this module as soon as program starts.
- */
 MODULE("Doggo");
 
-/*
- * This function is automatically called before registering the module. 
- * Use this to set some  global state needed eg: in check() function 
- */
 static void module_pre_start(void) {
     printf("Press 'c' to start playing with your own doggo...\n");
 }
 
-/*
- * Initializes this module's state;
- * returns a valid fd to be polled.
- */
 static void init(void) {
 
 }
 
-/* 
- * Whether this module should be actually created:
- * true if module must be created, !true otherwise.
- * 
- * Use this function as a starting filter: 
- * you may desire that a module is not started in certain conditions.
- */
 static bool check(void) {
     return true;
 }
 
-/* 
- * Should return not-0 value when module can be actually started (and thus polled).
- * Use this to check intra-modules dependencies or any other env variable.
- * 
- * Eg: you can evaluate your global state to make this module start right after
- * certain conditions are met.
- */
 static bool evaluate(void) {
     return true;
 }
 
-/*
- * Destroyer function, called at module unload (at end of program).
- * Note that any module's fds are automatically closed for you.
- */
 static void destroy(void) {
 
 }
 
-/*
- * Default poll callback
- */
 static void receive(const msg_t *msg, const void *userdata) {
     if (msg->is_pubsub) {
         switch (msg->ps_msg->type) {

Samples/Cpp/pippo.cpp

@@ -10,26 +10,14 @@
 
 static const self_t *doggo;
 
-/* 
- * Declare and automagically initialize 
- * this module as soon as program starts.
- */
 MODULE("Pippo");
 
 static void receive_ready(const msg_t *msg, const void *userdata);
 
-/*
- * This function is automatically called before registering the module. 
- * Use this to set some global state needed eg: in check() function 
- */
 static void module_pre_start(void) {
 
 }
 
-/*
- * Initializes this module's state;
- * returns a valid fd to be polled.
- */
 static void init(void) {
 #ifdef __linux__
     /* Add signal fd */
@@ -44,45 +32,24 @@ static void init(void) {
     m_register_fd(fd, 1, NULL);
 #endif
 
-    /* Add stdin fd */
+    /* Register stdin fd */
     m_register_fd(STDIN_FILENO, 0, NULL);
 
     m_ref("Doggo", &doggo);
 }
 
-/* 
- * Whether this module should be actually created:
- * true if module must be created, !true otherwise.
- * 
- * Use this function as a starting filter: 
- * you may desire that a module is not started in certain conditions.
- */
 static bool check(void) {
     return true;
 }
 
-/* 
- * Should return not-0 value when module can be actually started (and thus polled).
- * Use this to check intra-modules dependencies or any other env variable.
- * 
- * Eg: you can evaluate your global state to make this module start right after
- * certain conditions are met.
- */
 static bool evaluate(void) {
     return true;
 }
 
-/*
- * Destroyer function, called at module unload (at end of program).
- * Note that module's FD is automatically closed for you.
- */
 static void destroy(void) {
 
 }
 
-/*
- * Default poll callback
- */
 static void receive(const msg_t *msg, const void *userdata) {
     if (!msg->is_pubsub) {
         char c;

Samples/Easy/doggo.c

@@ -7,54 +7,24 @@ static void receive_sleeping(const msg_t *msg, const void *userdata);
 
 static const self_t *new_mod;
 
-/* 
- * Declare and automagically initialize 
- * this module as soon as program starts.
- */
 MODULE("Doggo");
 
-/*
- * This function is automatically called before registering the module. 
- * Use this to set some  global state needed eg: in check() function 
- */
 static void module_pre_start(void) {
     printf("Press 'c' to start playing with your own doggo...\n");
 }
 
-/*
- * Initializes this module's state;
- * returns a valid fd to be polled.
- */
 static void init(void) {
 
 }
 
-/* 
- * Whether this module should be actually created:
- * true if module must be created, !true otherwise.
- * 
- * Use this function as a starting filter: 
- * you may desire that a module is not started in certain conditions.
- */
 static bool check(void) {
     return true;
 }
 
-/* 
- * Should return not-0 value when module can be actually started (and thus polled).
- * Use this to check intra-modules dependencies or any other env variable.
- * 
- * Eg: you can evaluate your global state to make this module start right after
- * certain conditions are met.
- */
 static bool evaluate(void) {
     return true;
 }
 
-/*
- * Destroyer function, called at module unload (at end of program).
- * Note that any module's fds are automatically closed for you.
- */
 static void destroy(void) {
 
 }

Samples/Easy/pippo.c

@@ -10,28 +10,16 @@
 
 static const self_t *doggo;
 
-/* 
- * Declare and automagically initialize 
- * this module as soon as program starts.
- */
 MODULE("Pippo");
 
 static int myData = 5;
 
 static void receive_ready(const msg_t *msg, const void *userdata);
 
-/*
- * This function is automatically called before registering the module. 
- * Use this to set some  global state needed eg: in check() function 
- */
 static void module_pre_start(void) {
 
 }
 
-/*
- * Initializes this module's state;
- * returns a valid fd to be polled.
- */
 static void init(void) {
 #ifdef __linux__
     /* Add signal fd */
@@ -46,46 +34,25 @@ static void init(void) {
     m_register_fd(fd, 1, &myData);
 #endif
 
-    /* Add stdin fd */
+    /* Register stdin fd */
     m_register_fd(STDIN_FILENO, 0, NULL);
 
     /* Get Doggo module reference */
     m_ref("Doggo", &doggo);
 }
 
-/* 
- * Whether this module should be actually created:
- * true if module must be created, !true otherwise.
- * 
- * Use this function as a starting filter: 
- * you may desire that a module is not started in certain conditions.
- */
 static bool check(void) {
     return true;
 }
 
-/* 
- * Should return not-0 value when module can be actually started (and thus polled).
- * Use this to check intra-modules dependencies or any other env variable.
- * 
- * Eg: you can evaluate your global state to make this module start right after
- * certain conditions are met.
- */
 static bool evaluate(void) {
     return true;
 }
 
-/*
- * Destroyer function, called at module unload (at end of program).
- * Note that module's FD is automatically closed for you.
- */
 static void destroy(void) {
 
 }
 
-/*
- * Default poll callback
- */
 static void receive(const msg_t *msg, const void *userdata) {
     if (!msg->is_pubsub) {
         char c;

Samples/MultiCtx/a.c

@@ -8,26 +8,15 @@
 #include <string.h>
 
 static const char *myCtx = "FirstCtx";
-/* 
- * Declare and automagically initialize 
- * this module and its context as soon as program starts.
- */
+
 MODULE_CTX("A", myCtx);
 
-/*
- * This function is automatically called before registering the module. 
- * Use this to set some  global state needed eg: in check() function 
- */
 static void module_pre_start(void) {
 
 }
 
 static void receive_ready(const msg_t *msg, const void *userdata);
 
-/*
- * Initializes this module's state;
- * returns a valid fd to be polled.
- */
 static void init(void) {
 #ifdef __linux__
     int fd = timerfd_create(CLOCK_BOOTTIME, TFD_NONBLOCK);
@@ -41,39 +30,18 @@ static void init(void) {
 #endif
 }
 
-/* 
- * Whether this module should be actually created:
- * true if module must be created, !true otherwise.
- * 
- * Use this function as a starting filter: 
- * you may desire that a module is not started in certain conditions.
- */
 static bool check(void) {
     return true;
 }
 
-/* 
- * Should return not-0 value when module can be actually started (and thus polled).
- * Use this to check intra-modules dependencies or any other env variable.
- * 
- * Eg: you can evaluate your global state to make this module start right after
- * certain conditions are met.
- */
 static bool evaluate(void) {
     return true;
 }
 
-/*
- * Destroyer function, called at module unload (at end of program).
- * Note that module's FD is automatically closed for you.
- */
 static void destroy(void) {
 
 }
 
-/*
- * Default poll callback
- */
 static void receive(const msg_t *msg, const void *userdata) {
     if (!msg->is_pubsub) {
         uint64_t t;
@@ -93,10 +61,6 @@ static void receive(const msg_t *msg, const void *userdata) {
     }
 }
 
-/*
- * Secondary poll callback.
- * Use m_become(ready) to start using this second poll callback.
- */
 static void receive_ready(const msg_t *msg, const void *userdata) {
     if (!msg->is_pubsub) {
         uint64_t t;