improve TEMPLATE_AUTO_RELOAD docs

CHANGES

@@ -23,9 +23,8 @@ Version 1.0
 - Added :meth:`flask.Config.from_json`.
 - Added :attr:`flask.Flask.config_class`.
 - Added :meth:`flask.config.Config.get_namespace`.
-- Added ``TEMPLATES_AUTO_RELOAD`` config key. Now by default templates will be
+- Templates are no longer automatically reloaded outside of debug mode. This
-  reloaded every time a template is requested only if the application is
+  can be configured with the new ``TEMPLATES_AUTO_RELOAD`` config key.
-  running in debug mode.
 - Added a workaround for a limitation in Python 3.3's namespace loader.
 - Added support for explicit root paths when using Python 3.3's namespace
   packages.

docs/config.rst

@@ -182,12 +182,11 @@ The following configuration values are used internally by Flask:
                                   if they are not requested by an
                                   XMLHttpRequest object (controlled by
                                   the ``X-Requested-With`` header)
-``TEMPLATES_AUTO_RELOAD``         If this is set to `True` every time a template
+``TEMPLATES_AUTO_RELOAD``         Whether to check for modifications of
-                                  is requested Flask checks if the template was
+                                  the template source and reload it
-                                  modified and if yes, it will reload the
+                                  automatically. By default the value is
-                                  template. By default the value is ``None``
+                                  `None` which means that Flask checks
-                                  which means that Flask checks template
+                                  original file only in debug mode.
-                                  sources only in debug mode.
 ``EXPLAIN_TEMPLATE_LOADING``      If this is enabled then every attempt to
                                   load a template will write an info
                                   message to the logger explaining the