Document new framework option http_method_override

hacfi · hacfi · commit d879786996b1 · 2013-03-25T07:30:16.000+01:00
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
@@ -16,6 +16,7 @@ Configuration
 -------------
 
 * `secret`_
+* `http_method_override`_
 * `ide`_
 * `test`_
 * `trust_proxy_headers`_
@@ -49,6 +50,21 @@ it's used for generating the CSRF tokens, but it could be used in any other
 context where having a unique string is useful. It becomes the service container
 parameter named ``kernel.secret``.
 
+http_method_override
+~~~~~~
+
+.. versionadded:: 2.3
+    The ``http_method_override`` option is new in version 2.3
+
+**type**: ``Boolean`` **default**: ``true``
+
+This determines whether the '_method' request parameter is used as the intended
+HTTP method on POST requests. If enabled, the
+:method:`Request::enableHttpMethodParameterOverride <Symfony\\Component\\HttpFoundation\\Request::enableHttpMethodParameterOverride>`
+gets called automatically. It becomes the service container parameter named
+``kernel.http_method_override``. For more information, see
+:doc:`/cookbook/routing/method_parameters`.
+
 ide
 ~~~
 
@@ -379,6 +395,7 @@ Full Default Configuration
         framework:
             charset:              ~
             secret:               ~
+            http_method_override: true
             trust_proxy_headers:  false
             trusted_proxies:      []
             ide:                  ~
@@ -405,7 +422,7 @@ Full Default Configuration
             profiler:
                 enabled:              false
                 only_exceptions:      false
-                only_master_requests:  false
+                only_master_requests: false
                 dsn:                  file:%kernel.cache_dir%/profiler
                 username:
                 password:
