[#2292] Expanding section about the single command that shows and explains how to override the getDefinition method

weaverryan · weaverryan · commit 0b7d8f41f243 · 2013-03-21T07:12:14.000-05:00
diff --git a/components/console/introduction.rst b/components/console/introduction.rst
@@ -85,8 +85,8 @@ You also need to create the file to run at the command line which creates
 an ``Application`` and adds commands to it::
 
     #!/usr/bin/env php
-    # app/console
     <?php
+    // app/console
 
     use Acme\DemoBundle\Command\GreetCommand;
     use Symfony\Component\Console\Application;
diff --git a/components/console/single_command_tool.rst b/components/console/single_command_tool.rst
@@ -43,12 +43,32 @@ it is possible to remove this need by extending the application::
 
             return $defaultCommands;
         }
+
+        /**
+         * Overridden so that the application doesn't expect the command
+         * name to be the first argument.
+         */
+        public function getDefinition()
+        {
+            $inputDefinition = parent::getDefinition();
+            // clear out the normal first argument, which is the command name
+            $inputDefinition->setArguments();
+
+            return $inputDefinition;
+        }
     }
 
 When calling your console script, the command `MyCommand` will then always
 be used, without having to pass its name.
 
-.. note::
+You can also simplify how you execute the application::
+
+    #!/usr/bin/env php
+    <?php
+    // command.php
+
+    use Acme\Tool\MyApplication;
+
+    $application = new MyApplication();
+    $application->run();
 
-    If your command accepts one or more arguments, you may also want to override
-    the :method:`Symfony\\Component\\Console\\getDefaultInputDefinition` method.
