Skip to content

Commit

Permalink
[1.0.X] Fixed #6979 -- Fixed the documentation cross-reference betwee…
Browse files Browse the repository at this point in the history
…n the

TIME_ZONE setting and manual settings configuration.

Backport of r9175 from trunk.


git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.0.X@9178 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information
malcolmt committed Oct 6, 2008
1 parent f4a57be commit 378dadc
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 8 deletions.
5 changes: 3 additions & 2 deletions docs/ref/settings.txt
Original file line number Original file line Diff line number Diff line change
Expand Up @@ -1152,8 +1152,9 @@ multiple Django-powered sites, each with a separate time-zone setting.


Normally, Django sets the ``os.environ['TZ']`` variable to the time zone you Normally, Django sets the ``os.environ['TZ']`` variable to the time zone you
specify in the ``TIME_ZONE`` setting. Thus, all your views and models will specify in the ``TIME_ZONE`` setting. Thus, all your views and models will
automatically operate in the correct time zone. However, if you're using the automatically operate in the correct time zone. However, if you're manually
manual configuration option (see below), Django will *not* touch the ``TZ`` :ref:`manually configuring settings
<settings-without-django-settings-module>`, Django will *not* touch the ``TZ``
environment variable, and it'll be up to you to ensure your processes are environment variable, and it'll be up to you to ensure your processes are
running in the correct environment. running in the correct environment.


Expand Down
15 changes: 9 additions & 6 deletions docs/topics/settings.txt
Original file line number Original file line Diff line number Diff line change
Expand Up @@ -85,8 +85,8 @@ Default settings
================ ================


A Django settings file doesn't have to define any settings if it doesn't need A Django settings file doesn't have to define any settings if it doesn't need
to. Each setting has a sensible default value. These defaults live in the file to. Each setting has a sensible default value. These defaults live in the
``django/conf/global_settings.py``. module :file:`django/conf/global_settings.py`.


Here's the algorithm Django uses in compiling settings: Here's the algorithm Django uses in compiling settings:


Expand Down Expand Up @@ -176,7 +176,9 @@ itself, you likely don't want to have to set up an environment variable
pointing to a settings module. pointing to a settings module.


In these cases, you can configure Django's settings manually. Do this by In these cases, you can configure Django's settings manually. Do this by
calling ``django.conf.settings.configure()``. calling:

.. function:: django.conf.settings.configure(default_settings, **settings)


Example:: Example::


Expand All @@ -196,9 +198,10 @@ recommended -- when you're using a piece of the framework inside a larger
application. application.


Consequently, when configured via ``settings.configure()``, Django will not Consequently, when configured via ``settings.configure()``, Django will not
make any modifications to the process environment variables. (See the make any modifications to the process environment variables (see the
explanation of ``TIME_ZONE``, above, for why this would normally occur.) It's documentation of :setting:`TIME_ZONE` for why this would normally occur). It's
assumed that you're already in full control of your environment in these cases. assumed that you're already in full control of your environment in these
cases.


Custom default settings Custom default settings
----------------------- -----------------------
Expand Down

0 comments on commit 378dadc

Please sign in to comment.