[WIP] FormatterHelper docs

Author: wouterj

components/console/helpers/formatterhelper.rst

@@ -0,0 +1,25 @@
+.. index::
+    single: Console Helpers; Formatter Helper
+
+Formatter Helper
+================
+
+The Formatter helpers provides functions to format the output with colors.
+You can do more advanced things with this helper than the things in
+:ref:`components-console-coloring`.
+
+The FormatterHelper is included in the default helper set, which you can
+get by calling
+:method:`Symfony\\Component\\Console\\Command\\Command::getHelperSet`::
+
+    $formatter = $this->getHelperSet()->get('formatter');
+
+The methods return a string with the data for the console, you should decide
+what you are going to do with that data. In most cases you want to write
+that data to the console with
+:method:`Symfony\\Component\\Console\\Output\\Output::writeln`.
+
+Print messages in a section
+---------------------------
+
+Assume you want to print

components/console/introduction.rst

@@ -108,6 +108,8 @@ This prints::
 
     HELLO FABIEN
 
+.. _components-console-coloring:
+
 Coloring the Output
 ~~~~~~~~~~~~~~~~~~~