Minor tweaks

Author: javiereguiluz

console/input.rst

@@ -174,9 +174,10 @@ flag:
                 1
             );
 
-Note that while long options are separated from their value with an ``=``
-character, e.g. ``--iterations=5``, short options do not use any separator. The
-short option variant of the previous example would therefore be ``-i5``.
+Note that to comply with the `docopt standard`_, long options can specify their
+values after a white space or an ``=`` sign (e.g. ``--iterations 5`` or
+``--iterations=5``), but short options can only use white spaces or no
+separation at all (e.g. ``-i 5`` or ``-i5``).
 
 There are four option variants you can use:
 
@@ -188,8 +189,8 @@ There are four option variants you can use:
     behavior of options;
 
 ``InputOption::VALUE_REQUIRED``
-    This value is required (e.g. ``--iterations=5`` or ``-i5``), the option itself is
-    still optional;
+    This value is required (e.g. ``--iterations=5`` or ``-i5``), the option
+    itself is still optional;
 
 ``InputOption::VALUE_OPTIONAL``
     This option may or may not have a value (e.g. ``--yell`` or
@@ -225,13 +226,13 @@ values after a white space or an ``=`` sign (e.g. ``--iterations 5`` or
 ``--iterations=5``), but short options can only use white spaces or no
 separation at all (e.g. ``-i 5`` or ``-i5``).
 
-.. _`docopt standard`: http://docopt.org/
+.. caution::
 
-.. tip::
-
-    While it is possible to use whitespace to separate an option from its value,
+    While it is possible to separate an option from its value with a white space,
     using this form leads to an ambiguity should the option appear before the
-    command name. In other words, ``php bin/console --iterations 5 app:greet Fabien``
+    command name. For example, ``php bin/console --iterations 5 app:greet Fabien``
     is ambiguous; Symfony would interpret ``5`` as the command name. To avoid
     this situation, always place options after the command name, or avoid using
     a space to separate the option name from its value.
+
+.. _`docopt standard`: http://docopt.org/