add formatting message description in README file

Author: skitoo

README.rst

@@ -5,7 +5,7 @@ Rozenn is a Flash/AS3 logging system strongly inspired by the famous `Log4J <htt
 
 Installation
 ============
-The best way to use Rozenn is by adding the provided SWC file to your project. But you can download source code and put it in your classpath.
+The best way to install Rozenn is by adding the provided SWC file to your project. But you can download source code and put it in your classpath.
 
 Usage
 =====
@@ -16,15 +16,15 @@ The logger is the basic entity of the system logger. He is represented by the cl
 
 ::
 
-   package
-   {
-      import org.rozenn.Logger;
-    
-      public class MyClass
+      package
       {
-         private static var logger : Logger = Logger.getLogger(MyClass);
+         import org.rozenn.Logger;
+       
+         public class MyClass
+         {
+            private static var logger : Logger = Logger.getLogger(MyClass);
+         }
       }
-   }
    
 As you can see the declaration of a logger is very simple. It is done by the static method **Logger.getLogger**. This one take parent class name as parameter. You can give a different name but it is preferable to use the class to be used by the system of hierarchy and configuration.
 
@@ -51,10 +51,10 @@ To log a message several methods of the Logger available to you:
 
 ::
 
-   logger.log(Level.DEBUG, "debug message");
- 
-   // the same with debug method
-   logger.debug("debug message");
+      logger.log(Level.DEBUG, "debug message");
+    
+      // the same with debug method
+      logger.debug("debug message");
    
 
 Of course these two methods are applicable for the other 4 levels: **INFO**, **WARN**, **ERROR** and **FATAL**.
@@ -71,3 +71,44 @@ To date four implementations are provided with Rozenn:
    * **org.rozenn.layout.FlashInspectorLayout** – Messages are sent to FlashInspector application  developped by `Pablo Constantini <http://www.luminicbox.com/>`_.
    * **org.rozenn.layout.FireBugLayout** – Messages are sent to the inevitable Firefox plugin `FireBug <http://getfirebug.com/>`_. Of course your SWF to be played with the browser, the messages appear in the module "Console" plugin.
 
+Formatting messages
+-------------------
+Rozenn can format the logging messages. This action takes place before they are sent to a layout. The formatting of messages is done by classes implementing the interface **org.rozenn.formatter.IFormatter**. These objects are associated with the layouts.
+
+Rozenn offers two formatters:
+   * **org.rozenn.formatter.SimpleFormatter** – A formatter very simple: it passes the message body to layout as that is.
+   * **org.rozenn.formatter.PatternFormatter** – This formatter is more advanced. Its constructor takes a pattern that will define the form that will take a message once sent to the layout.
+   
+Example for pattern **%L [%C] %M** :
+
+::
+
+      var logger : Logger = Logger.getLogger("root");
+      logger.debug("Message A");
+      logger.warn("Message B");
+   
+result :
+
+::
+
+      DEBUG [root] Message A
+      WARN [root] Message B
+   
+Table summary tags:
++--------+-------------------------------------------------------------------------------------------------------------------------------------+
+| Tag    | Result                                                                                                                              |
++========+=====================================================================================================================================+
+| **%C** | The name of the sender of the message log.                                                                                          |
++--------+-------------------------------------------------------------------------------------------------------------------------------------+
+| **%D** | The issue date of the message.                                                                                                      |
+|        | This tag is a bit special because it accepts an option: **%D{dd/MM/yyyy – HH:mm:ss}**                                               |
+|        | This option lets you specify as the date will be displayed. This option is analyzed by the class **org.rozenn.utils.DateFormatter** |
+|        | I suggest you take a look at the documentation of the latter.                                                                       |
++--------+-------------------------------------------------------------------------------------------------------------------------------------+
+| **%L** | The message level                                                                                                                   |
++--------+-------------------------------------------------------------------------------------------------------------------------------------+
+| **%M** | The message body                                                                                                                    |
++--------+-------------------------------------------------------------------------------------------------------------------------------------+
+
+
+