minor symfony#13231 [WIP] Made help information of commands more consistent (WouterJ)

This PR was squashed before being merged into the 2.3 branch (closes symfony#13231).

Discussion
----------

[WIP] Made help information of commands more consistent

| Q   | A
| --- | ---
| Test pass | Not yet
| License | MIT
| Fixed tickets | -

Commits
-------

602d687 [WIP] Made help information of commands more consistent

Author: fabpot

src/Symfony/Bundle/FrameworkBundle/Command/AssetsInstallCommand.php

@@ -39,21 +39,21 @@ protected function configure()
             ->setDescription('Installs bundles web assets under a public web directory')
             ->setHelp(<<<EOT
 The <info>%command.name%</info> command installs bundle assets into a given
-directory (e.g. the web directory).
+directory (e.g. the <comment>web</comment> directory).
 
-<info>php %command.full_name% web</info>
+  <info>php %command.full_name% web</info>
 
-A "bundles" directory will be created inside the target directory, and the
+A "bundles" directory will be created inside the target directory and the
 "Resources/public" directory of each bundle will be copied into it.
 
 To create a symlink to each bundle instead of copying its assets, use the
 <info>--symlink</info> option:
 
-<info>php %command.full_name% web --symlink</info>
+  <info>php %command.full_name% web --symlink</info>
 
 To make symlink relative, add the <info>--relative</info> option:
 
-<info>php %command.full_name% web --symlink --relative</info>
+  <info>php %command.full_name% web --symlink --relative</info>
 
 EOT
             )

src/Symfony/Bundle/FrameworkBundle/Command/CacheClearCommand.php

@@ -41,8 +41,8 @@ protected function configure()
 The <info>%command.name%</info> command clears the application cache for a given environment
 and debug mode:
 
-<info>php %command.full_name% --env=dev</info>
-<info>php %command.full_name% --env=prod --no-debug</info>
+  <info>php %command.full_name% --env=dev</info>
+  <info>php %command.full_name% --env=prod --no-debug</info>
 EOF
             )
         ;

src/Symfony/Bundle/FrameworkBundle/Command/ContainerDebugCommand.php

@@ -59,23 +59,23 @@ protected function configure()
   <info>php %command.full_name% validator</info>
 
 By default, private services are hidden. You can display all services by
-using the --show-private flag:
+using the <info>--show-private</info> flag:
 
   <info>php %command.full_name% --show-private</info>
 
 Use the --tags option to display tagged <comment>public</comment> services grouped by tag:
 
   <info>php %command.full_name% --tags</info>
 
-Find all services with a specific tag by specifying the tag name with the --tag option:
+Find all services with a specific tag by specifying the tag name with the <info>--tag</info> option:
 
   <info>php %command.full_name% --tag=form.type</info>
 
-Use the --parameters option to display all parameters:
+Use the <info>--parameters</info> option to display all parameters:
 
   <info>php %command.full_name% --parameters</info>
 
-Display a specific parameter by specifying his name with the --parameter option:
+Display a specific parameter by specifying his name with the <info>--parameter</info> option:
 
   <info>php %command.full_name% --parameter=kernel.debug</info>
 EOF

src/Symfony/Bundle/FrameworkBundle/Command/RouterApacheDumperCommand.php

@@ -49,7 +49,7 @@ protected function configure()
         $this
             ->setName('router:dump-apache')
             ->setDefinition(array(
-                new InputArgument('script_name', InputArgument::OPTIONAL, 'The script name of the application\'s front controller.'),
+                new InputArgument('script_name', InputArgument::OPTIONAL, 'The script name of the application\'s front controller'),
                 new InputOption('base-uri', null, InputOption::VALUE_REQUIRED, 'The base URI'),
             ))
             ->setDescription('Dumps all routes as Apache rewrite rules')

src/Symfony/Bundle/FrameworkBundle/Command/TranslationUpdateCommand.php

@@ -36,26 +36,11 @@ protected function configure()
             ->setDefinition(array(
                 new InputArgument('locale', InputArgument::REQUIRED, 'The locale'),
                 new InputArgument('bundle', InputArgument::REQUIRED, 'The bundle where to load the messages'),
-                new InputOption(
-                    'prefix', null, InputOption::VALUE_OPTIONAL,
-                    'Override the default prefix', '__'
-                ),
-                new InputOption(
-                    'output-format', null, InputOption::VALUE_OPTIONAL,
-                    'Override the default output format', 'yml'
-                ),
-                new InputOption(
-                    'dump-messages', null, InputOption::VALUE_NONE,
-                    'Should the messages be dumped in the console'
-                ),
-                new InputOption(
-                    'force', null, InputOption::VALUE_NONE,
-                    'Should the update be done'
-                ),
-                new InputOption(
-                    'clean', null, InputOption::VALUE_NONE,
-                    'Should clean not found messages'
-                ),
+                new InputOption('prefix', null, InputOption::VALUE_OPTIONAL, 'Override the default prefix', '__'),
+                new InputOption('output-format', null, InputOption::VALUE_OPTIONAL, 'Override the default output format', 'yml'),
+                new InputOption('dump-messages', null, InputOption::VALUE_NONE, 'Should the messages be dumped in the console'),
+                new InputOption('force', null, InputOption::VALUE_NONE, 'Should the update be done'),
+                new InputOption('clean', null, InputOption::VALUE_NONE, 'Should clean not found messages'),
             ))
             ->setDescription('Updates the translation file')
             ->setHelp(<<<EOF
@@ -64,8 +49,8 @@ protected function configure()
 When new translation strings are found it can automatically add a prefix to the translation
 message.
 
-<info>php %command.full_name% --dump-messages en AcmeBundle</info>
-<info>php %command.full_name% --force --prefix="new_" fr AcmeBundle</info>
+  <info>php %command.full_name% --dump-messages en AcmeBundle</info>
+  <info>php %command.full_name% --force --prefix="new_" fr AcmeBundle</info>
 EOF
             )
         ;

src/Symfony/Bundle/SecurityBundle/Command/InitAclCommand.php

@@ -34,13 +34,13 @@ protected function configure()
             ->setHelp(<<<EOF
 The <info>%command.name%</info> command mounts ACL tables in the database.
 
-<info>php %command.full_name%</info>
+  <info>php %command.full_name%</info>
 
 The name of the DBAL connection must be configured in your <info>app/config/security.yml</info> configuration file in the <info>security.acl.connection</info> variable.
 
-<info>security:
-    acl:
-        connection: default</info>
+  <info>security:
+      acl:
+          connection: default</info>
 EOF
             )
         ;

src/Symfony/Bundle/TwigBundle/Command/LintCommand.php

@@ -33,21 +33,21 @@ protected function configure()
 The <info>%command.name%</info> command lints a template and outputs to stdout
 the first encountered syntax error.
 
-<info>php %command.full_name% filename</info>
+  <info>php %command.full_name% filename</info>
 
 The command gets the contents of <comment>filename</comment> and validates its syntax.
 
-<info>php %command.full_name% dirname</info>
+  <info>php %command.full_name% dirname</info>
 
 The command finds all twig templates in <comment>dirname</comment> and validates the syntax
 of each Twig template.
 
-<info>php %command.full_name% @AcmeMyBundle</info>
+  <info>php %command.full_name% @AcmeMyBundle</info>
 
 The command finds all twig templates in the <comment>AcmeMyBundle</comment> bundle and validates
 the syntax of each Twig template.
 
-<info>cat filename | php %command.full_name%</info>
+  <info>cat filename | php %command.full_name%</info>
 
 The command gets the template contents from stdin and validates its syntax.
 EOF

src/Symfony/Bundle/WebProfilerBundle/Command/ExportCommand.php

@@ -56,7 +56,7 @@ protected function configure()
             ->setHelp(<<<EOF
 The <info>%command.name%</info> command exports a profile to the standard output:
 
-<info>php %command.full_name% profile_token</info>
+  <info>php %command.full_name% profile_token</info>
 EOF
             )
         ;

src/Symfony/Bundle/WebProfilerBundle/Command/ImportCommand.php

@@ -56,11 +56,11 @@ protected function configure()
             ->setHelp(<<<EOF
 The <info>%command.name%</info> command imports a profile:
 
-<info>php %command.full_name% profile_filepath</info>
+  <info>php %command.full_name% profile_filepath</info>
 
 You can also pipe the profile via STDIN:
 
-<info>cat profile_file | php %command.full_name%</info>
+  <info>cat profile_file | php %command.full_name%</info>
 EOF
             )
         ;

src/Symfony/Component/Console/Application.php

@@ -936,13 +936,13 @@ protected function getDefaultInputDefinition()
         return new InputDefinition(array(
             new InputArgument('command', InputArgument::REQUIRED, 'The command to execute'),
 
-            new InputOption('--help',           '-h', InputOption::VALUE_NONE, 'Display this help message.'),
-            new InputOption('--quiet',          '-q', InputOption::VALUE_NONE, 'Do not output any message.'),
-            new InputOption('--verbose',        '-v|vv|vvv', InputOption::VALUE_NONE, 'Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug.'),
-            new InputOption('--version',        '-V', InputOption::VALUE_NONE, 'Display this application version.'),
-            new InputOption('--ansi',           '',   InputOption::VALUE_NONE, 'Force ANSI output.'),
-            new InputOption('--no-ansi',        '',   InputOption::VALUE_NONE, 'Disable ANSI output.'),
-            new InputOption('--no-interaction', '-n', InputOption::VALUE_NONE, 'Do not ask any interactive question.'),
+            new InputOption('--help',           '-h', InputOption::VALUE_NONE, 'Display this help message'),
+            new InputOption('--quiet',          '-q', InputOption::VALUE_NONE, 'Do not output any message'),
+            new InputOption('--verbose',        '-v|vv|vvv', InputOption::VALUE_NONE, 'Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug'),
+            new InputOption('--version',        '-V', InputOption::VALUE_NONE, 'Display this application version'),
+            new InputOption('--ansi',           '',   InputOption::VALUE_NONE, 'Force ANSI output'),
+            new InputOption('--no-ansi',        '',   InputOption::VALUE_NONE, 'Disable ANSI output'),
+            new InputOption('--no-interaction', '-n', InputOption::VALUE_NONE, 'Do not ask any interactive question'),
         ));
     }