Applied (most of) the comments

Author: wouterj

reference/configuration/framework.rst

@@ -48,7 +48,7 @@ Configuration
     * `lifetime`_
     * `matcher`_
         * `ip`_
-        * `path`_
+        * :ref:`path <profiler.matcher.path>`
         * `service`_
 * router
     * resource
@@ -237,8 +237,8 @@ default_locale
 
 **type**: ``string`` **default**: ``'en'``
 
-If the locale can't be determined from the Request or session, the default
-locale will be used. It becomes the service container parameter called
+If the locale can't be determined from the Request, the default locale will be
+used. It becomes the service container parameter called
 ``kernel.default_locale``.
 
 .. seealso::
@@ -279,7 +279,7 @@ subdomains).
 
 .. seealso::
 
-   Read more about this in the `Security Advisory Blog post`_.
+    Read more about this in the `Security Advisory Blog post`_.
 
 .. _reference-framework-form:
 
@@ -295,16 +295,16 @@ enabled
 
 Whether to enable the form services or not in the service container.
 
-This option will be set to ``true`` automatically when one of the child
-settings are configured.
+This option will automatically be set to ``true`` when one of the child
+settings is configured.
 
 .. note::
 
-   This will automatically enable the validation.
+    This will automatically enable the validation.
 
 .. seealso::
 
-   For more details, see :doc:`/book/forms`.
+    For more details, see :doc:`/book/forms`.
 
 csrf_protection
 ~~~~~~~~~~~~~~~
@@ -321,11 +321,11 @@ enabled
 **type**: ``boolean`` **default**: ``false``
 
 Whether to enable the CSRF support in forms or not. Setting this option to
-``true`` requires the `secret`_ to be set and the `session`_ to be enabled. It
+``true`` requires the `secret`_ to be set and `session`_ to be enabled. It
 becomes the service container parameter named ``form.type_extension.csrf.enabled``.
 
-This option will be set to ``true`` automatically when one of the child
-settings are configured.
+This option will automatically be set to ``true`` when one of the child
+settings is configured.
 
 field_name
 ..........
@@ -387,7 +387,7 @@ enabled
 **type**: ``boolean`` **default**: ``false``
 
 Whether to enable the fragment listener or not. The fragment listener is used
-to render ESI fragments independently of the rst of the page.
+to render ESI fragments independently of the rest of the page.
 
 This setting is automatically set to ``true`` when one of the child settings is
 configured.
@@ -399,8 +399,8 @@ path
 
 **type**: ``string`` **default**: ``'/_fragment'``
 
-The paths prefix for fragments. The fragment listener will only be executed
-when the requests starts with this path. It becomes the service container
+The path prefix for fragments. The fragment listener will only be executed
+when the request starts with this path. It becomes the service container
 parameter called ``fragment.path``.
 
 profiler
@@ -418,12 +418,13 @@ enabled
 
 **type**: ``boolean`` **default**: ``true`` in the ``dev`` and ``test`` environments
 
-The profiler can be disabled by setting this setting to ``false``.
+The profiler can be disabled by setting this option to ``false``.
 
 .. note::
 
     The profiler works independently from the Web Developer Toolbar, see the
-    :doc:`WebProfilerBundle configuration <web_profiler>` on how to disable/enable it.
+    :doc:`WebProfilerBundle configuration
+    </reference/configuration/web_profiler>` on how to disable/enable it.
 
 collect
 .......
@@ -439,7 +440,7 @@ collect
 This option configures the way the profiler behaves when it is enabled. If set
 to ``true``, the profiler collects data for all requests. If you want to only
 collect information on-demand, you can set the ``collect`` flag to ``false``
-and activate the data collectors by hand::
+and activate the data collectors manually::
 
     $profiler->enable();
 
@@ -518,7 +519,9 @@ ip
 
 **type**: ``string``
 
-If set, the profiler will only be enabled when the current IP adres matches.
+If set, the profiler will only be enabled when the current IP address matches.
+
+.. _profiler.matcher.path:
 
 path
 """"