diff options
| author | Chris McDonough <chrism@plope.com> | 2011-01-19 01:37:18 -0500 |
|---|---|---|
| committer | Chris McDonough <chrism@plope.com> | 2011-01-19 01:37:18 -0500 |
| commit | e3bb4cd9e413e58ec6c7ea7d4682bac329b712dd (patch) | |
| tree | b0c3b4f5dd8a0ec1c01912bfeff769d1329a9c97 /docs/narr/environment.rst | |
| parent | 48bccbe4ff7351d823a471005effea1afc06bb4f (diff) | |
| parent | b0240d3d5a39a504d5a5155a23a6d6a431b457ef (diff) | |
| download | pyramid-e3bb4cd9e413e58ec6c7ea7d4682bac329b712dd.tar.gz pyramid-e3bb4cd9e413e58ec6c7ea7d4682bac329b712dd.tar.bz2 pyramid-e3bb4cd9e413e58ec6c7ea7d4682bac329b712dd.zip | |
Merge branch 'caseman-master'
Diffstat (limited to 'docs/narr/environment.rst')
| -rw-r--r-- | docs/narr/environment.rst | 17 |
1 files changed, 13 insertions, 4 deletions
diff --git a/docs/narr/environment.rst b/docs/narr/environment.rst index 7caa1dcc6..7b7946aae 100644 --- a/docs/narr/environment.rst +++ b/docs/narr/environment.rst @@ -38,10 +38,11 @@ application-specific configuration settings. Reloading Templates ------------------- -When this value is true, reload templates without a restart, so you can see -changes to templates take effect immediately during development. This flag -is meaningful to Chameleon and Mako templates, as well as most third-party -template rendering extensions. +When this value is true, templates are automatically reloaded whenever +they are modified without restarting the application, so you can see +changes to templates take effect immediately during development. This +flag is meaningful to Chameleon and Mako templates, as well as most +third-party template rendering extensions. +---------------------------------+-----------------------------+ | Environment Variable Name | Config File Setting Name | @@ -335,6 +336,14 @@ with ``reload_``). on in one fell swoop, you can use affect settings that do not start with ``reload_*`` such as ``debug_notfound``. +.. note:: + Specifying configuration settings via environment variables is generally + most useful during development, where you may wish to augment or + override the more permanent settings in the configuration file. + This is useful because many of the reload and debug settings may + have performance or security (i.e., disclosure) implications + that make them undesirable in a production environment. + .. index:: single: reload_templates single: reload_assets |