[symfony#2217] Tweaks to new entry about overriding kernel configuration by @wouterj. Thanks to @stof for some of the details here.

weaverryan · weaverryan · commit 672ded5eb9d4 · 2013-03-03T20:08:38.000-06:00
diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
@@ -1,37 +1,43 @@
 .. index::
     single: Configuration reference; Kernel class
 
-Configuration in the ``AppKernel``
-==================================
+Configuring in the Kernel (e.g. AppKernel)
+==========================================
 
-Some configuration can be done in the ``AppKernel`` class (which is located in
-``app/AppKernel.php``. You can do this by overriding the method of the
-:class:`Symfony\\Component\\HttpKernel\\Kernel` class, which is extended by
-the ``AppKernel`` class.
+Some configuration can be done on the kernel class itself (usually called
+``app/AppKernel.php``). You can do this by overriding specific methods in
+the parent :class:`Symfony\\Component\\HttpKernel\\Kernel` class.
 
 Configuration
 -------------
 
-* `kernel name`_
-* `root directory`_
-* `cache directory`_
-* `log directory`_
+* `Kernel Name`_
+* `Root Directory`_
+* `Cache Directory`_
+* `Log Directory`_
 
-kernel name
+Kernel Name
 ~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``$this->name``
+**type**: ``string`` **default**: ``app`` (i.e. the directory name holding the kernel class)
 
-To change this setting, override the
-:method:`Symfony\\Component\\HttpKernel\\Kernel::getName` method.
+To change this setting, override the :method:`Symfony\\Component\\HttpKernel\\Kernel::getName`
+method. Alternatively, move your kernel into a different directory. For example,
+if you moved the kernel into a ``foo`` directory (instead of ``app``), the
+kernel name will be ``foo``.
+
+The name of the kernel isn't usually directly important - it's used in the
+generation of cache files. If you have an application with multiple kernels,
+the easiest way to make each have a unique name is to duplicate the ``app``
+directory and rename it to something else (e.g. ``foo``).
 
-root directory
+Root Directory
 ~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: the directory of ``AppKernel``
 
-This returns the root directory of you Symfony2 application. If you use the
-Symfony Standard edition, the root directory refers to the ``app`` directory.
+This returns the root directory of your kernel. If you use the Symfony Standard
+edition, the root directory refers to the ``app`` directory.
 
 To change this setting, override the
 :method:`Symfony\\Component\\HttpKernel\\Kernel::getRootDir` method::
@@ -49,20 +55,20 @@ To change this setting, override the
         }
     }
 
-cache directory
+Cache Directory
 ~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``$this->rootDir/cache/$this->environment``
 
-This returns the cache directory. You need to override the
+This returns the path to the cache directory. To change it, override the
 :method:`Symfony\\Component\\HttpKernel\\Kernel::getCacheDir` method. Read
 ":ref:`override-cache-dir`" for more information.
 
-log directory
+Log Directory
 ~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``$this->rootDir/logs``
 
-This returns the log directory. You need to override the
+This returns the path to the log directory. To change it, override the
 :method:`Symfony\\Component\\HttpKernel\\Kernel::getLogDir` method. Read
 ":ref:`override-logs-dir`" for more information.
diff --git a/reference/map.rst.inc b/reference/map.rst.inc
@@ -9,12 +9,12 @@
   * :doc:`doctrine </reference/configuration/doctrine>`
   * :doc:`security </reference/configuration/security>`
   * :doc:`assetic </reference/configuration/assetic>`
-  * :doc:`swiftMailer </reference/configuration/swiftmailer>`
+  * :doc:`swiftmailer </reference/configuration/swiftmailer>`
   * :doc:`twig </reference/configuration/twig>`
   * :doc:`monolog </reference/configuration/monolog>`
   * :doc:`web_profiler </reference/configuration/web_profiler>`
 
-* :doc:`Configuration in the Kernel </reference/configuration/kernel>`
+* :doc:`Configuring the Kernel (e.g. AppKernel) </reference/configuration/kernel>`
 
 * **Forms and Validation**
 
