Browse files

Made it clear that we do not alter the process environment when manua…

…l settings

configuration is used.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
malcolmt committed Jul 12, 2006
1 parent 085b744 commit e88a9cc9a40f2c37ac12e9fb9a706264cf28445e
Showing with 16 additions and 0 deletions.
  1. +16 −0 docs/settings.txt
@@ -760,6 +760,13 @@ Note that this is the time zone to which Django will convert all dates/times --
not necessarily the timezone of the server. For example, one server may serve
multiple Django-powered sites, each with a separate time-zone setting.
+Normally, Django will set the ``os.environ['TZ']`` variable to the timezone
+you specify in this variable. All your views and models will therefore
+automatically operate in the correct timezone. However, if you are using the
+manual configuration option (see below), the environment variable will not be
+touched and it is up to you to ensure your processes are running in the
+correct environment.
@@ -837,6 +844,15 @@ uppercase, with the same name as the settings described above. If a particular
setting is not passed to ``configure()`` and is needed at some later point,
Django will use the default setting value.
+Configuring Django in this fashion is mostly necessary -- and, indeed,
+recommended -- when you are using a piece of the Django framework inside a
+larger application. Consequently, when configured via
+``settings.configure()``, Django will not make any modifications to the
+process environment (see the explanation of ``TIME_ZONE``, above, for why this
+would normally occur). It is assumed that you are already in full control of
+your environment in these cases and have configured your environment as
+required in some other fashion.
Custom default settings

0 comments on commit e88a9cc

Please sign in to comment.