Active-Object.md

 The **Active Object** design pattern decouples method execution from method invocation.
 An active object is an object that "runs" in a *separate thread*.  
   
-It can be useful for in a situation in which an object has to periodically pop elements from a queue, which are in turn produced by a second thread or for example for a receiver object that has to continuously check for incoming messages.
-
-## Methods
+It can be useful for in a situation in which an object has to periodically pop elements from a queue, which are in turn produced by a second thread or for example for a receiver object that has to continuously check for incoming messages.  
+  
+In `src/shared/` you can find the corresponding template. 
 
-In `src/shared/` you can find the corresponding template.  
+## Implementation 
 The most relevant functions are:
-- **Constructor**: creates a Miosix Thread.
-- **threadLauncher**: private static function that is executed from the Thread, calls the run() method.
-- **run**: protected method, should be overridden with the code that you want to run on the Thread.
-
-In order to start the active object you can call `start()` while you can call `stop()` in order to stop it.
+- **virtual bool start()**: creates a Miosix Thread, which in turn call *threadLauncher()*. It returns a bool indicating whether the thread was correctly created or not.
+- **virtual void stop()**: stop the ActiveObject's and join its thread.
+- **static void threadLauncher(void\* arg)**: private static function that is executed from the thread, which in turn calls the *run()* method.
+- **virtual void run()**: protected method, should be overridden with the code that you want to run in the thread.
 
 ## Example
 
@@ -21,15 +20,17 @@ In order to start the active object you can call `start()` while you can call `s
  * module and forwards an event to the EventBroker accordingly to the received	
  * message.	
  */	
-class Receiver : ActiveObject {	
+class Receiver : ActiveObject 
+{	
     	
 public:	
     /* Constructor: sets the RF driver to use */	
-    Receiver(Gamma868* gamma) {	
+    Receiver(Gamma868* gamma) 
+    {	
         this->gamma = gamma;	
     }	
     	
-    /* Deconstructor */	
+    /* Destructor */	
     ~Receiver() {}	
     	
 protected:	
@@ -37,10 +38,12 @@ protected:
      * Function executed in a separate thread: waits for a packet and forwards	
      * the corresponding event.	
      */	
-    void run() {
+    void run() override
+    {
        // Infinite loop
-       while(1) {
-            // Do stuff
+       while(1) 
+       {
+            ... // do stuff
        }
     }
 	
@@ -48,4 +51,21 @@ private:
     Gamma868* gamma;	
 
 };
+```
+
+And in the main:
+```cpp
+int main()
+{
+    Receiver rec(new Gamma868(...));
+
+    if (rec.start()) 
+    {
+        ... // do stuff
+
+        rec.stop();
+    }
+
+    return 0;
+}
 ```
\ No newline at end of file