[#1778] Adding index entries and tweaks via @wouterj for the new Command URL generation cookbook entry

Author: weaverryan

cookbook/console/generating_urls.rst

@@ -1,15 +1,19 @@
 .. index::
    single: Console; Generating URLs
 
-How to generate URLs with a custom host in Console Commands
+How to generate URLs with a custom Host in Console Commands
 ===========================================================
 
-The command line context does not know about your VirtualHost or domain name,
-therefore if you generate absolute URLs within a Console Command you generally
-end up with something like ``http://localhost/foo/bar`` which is not very
-useful.
+Unfortunately, the command line context does not know about your VirtualHost
+or domain name. This means that if if you generate absolute URLs within a
+Console Command you'll probably end up with something like ``http://localhost/foo/bar``
+which is not very useful.
 
-There are two ways of configuring the request context, at the application level
+To fix this, you need to configure the "request context", which is a fancy
+way of saying that you need to configure your environment so that it knows
+what URL it should use when generating URLs.
+
+There are two ways of configuring the request context: at the application level
 and per Command.
 
 Configuring the Request Context globally
@@ -31,8 +35,6 @@ via normal web requests, since those will override the defaults.
 
     .. code-block:: xml
 
-        <!-- app/config/parameters.xml -->
-
         <?xml version="1.0" encoding="UTF-8"?>
 
         <container xmlns="http://symfony.com/schema/dic/services"
@@ -54,11 +56,11 @@ Configuring the Request Context per Command
 -------------------------------------------
 
 To change it only in one command you can simply fetch the Request Context
-service and override its settings:
-
-.. code-block:: php
+service and override its settings::
 
     // src/Acme/DemoBundle/Command/DemoCommand.php
+    // ...
+
     class DemoCommand extends ContainerAwareCommand
     {
         protected function execute(InputInterface $input, OutputInterface $output)
@@ -67,7 +69,7 @@ service and override its settings:
             $context->setHost('example.com');
             $context->setScheme('https');
 
-            // your code here
+            // ... your code here
         }
     }
 

cookbook/console/index.rst

@@ -6,3 +6,4 @@ Console
 
     console_command
     usage
+    generating_urls

cookbook/map.rst.inc

@@ -28,6 +28,7 @@
 
   * :doc:`/cookbook/console/console_command`
   * :doc:`/cookbook/console/usage`
+  * :doc:`/cookbook/console/generating_urls`
 
 * :doc:`/cookbook/controller/index`