[cookbook] Minor tweaks to new apache route dumper article - see #1347

weaverryan · weaverryan · commit 6d1b77f2fde1 · 2012-05-19T15:50:39.000-05:00
diff --git a/cookbook/configuration/apache_router.rst b/cookbook/configuration/apache_router.rst
@@ -1,17 +1,17 @@
 .. index::
    single: Apache Router
 
-How to use Apache Router
-========================
+How to use the Apache Router
+============================
 
 Symfony2, while fast out of the box, also provides various ways to increase that speed with a little bit of tweaking.
 One of these ways is by letting apache handle routes directly, rather than using Symfony2 for this task.
 
 Change Router Configuration Parameters
 --------------------------------------
 
-To to be to dump Apache routes we must first tweak configuration parameters and tell
-Symfony2 to use ApacheUrlMatcher instead of the default one:
+To dump Apache routes we must first tweak some configuration parameters to tell
+Symfony2 to use the ``ApacheUrlMatcher`` instead of the default one:
 
 .. code-block:: yaml
     
@@ -22,12 +22,14 @@ Symfony2 to use ApacheUrlMatcher instead of the default one:
 
 .. tip::
 
-    Note that :class: `Symfony\\Component\\Routing\\Matcher\\ApacheUrlMatcher` extends :class: `Symfony\\Component\\Routing\\Matcher\\UrlMatcher` so even if you don't regenerate 
-    the url_rewrite rules, everything will work (because at the end of **ApacheUrlMatcher::match()** 
-    a call to **parent::match()** is done). 
+    Note that :class:`Symfony\\Component\\Routing\\Matcher\\ApacheUrlMatcher`
+    extends :class:`Symfony\\Component\\Routing\\Matcher\\UrlMatcher` so even
+    if you don't regenerate the url_rewrite rules, everything will work (because
+    at the end of ``ApacheUrlMatcher::match()`` a call to ``parent::match()``
+    is done). 
     
 Generating mod_rewrite rules
----------------------------
+----------------------------
     
 To test that it's working, let's create a very basic route for demo bundle:
 
@@ -57,9 +59,10 @@ Which should roughly output the following:
     RewriteCond %{REQUEST_URI} ^/hello/([^/]+?)$
     RewriteRule .* app.php [QSA,L,E=_ROUTING__route:hello,E=_ROUTING_name:%1,E=_ROUTING__controller:AcmeDemoBundle\:Demo\:hello]
 
-You can now rewrite `web/.htaccess` to use new rules, so with our example it should look like this:
+You can now rewrite `web/.htaccess` to use the new rules, so with our example
+it should look like this:
 
-.. code-block:: text
+.. code-block:: apache
 
     <IfModule mod_rewrite.c>
         RewriteEngine On
@@ -83,7 +86,8 @@ You're now all set to use Apache Route rules.
 Additional tweaks
 -----------------
 
-To save a little bit of processing time, change in **web/app.php** occurences of **Request** into **ApacheRequest**::
+To save a little bit of processing time, change occurrences of ``Request``
+to ``ApacheRequest`` in ``web/app.php``::
 
     // web/app.php
     
diff --git a/cookbook/configuration/index.rst b/cookbook/configuration/index.rst
@@ -7,3 +7,4 @@ Configuration
     environments
     external_parameters
     pdo_session_storage
+    apache_router
diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc
@@ -21,6 +21,7 @@
   * :doc:`/cookbook/configuration/environments`
   * :doc:`/cookbook/configuration/external_parameters`
   * :doc:`/cookbook/configuration/pdo_session_storage`
+  * :doc:`/cookbook/configuration/apache_router`
 
 * **Console Commands**
 
