Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Fixed #2274 -- Fixed error in settings documentation. Thanks, Le Roux…

… Bodenstein

git-svn-id: http://code.djangoproject.com/svn/django/trunk@3252 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit e37bb07bc6804b852adb6846b59f555b918b6684 1 parent bd6a758
@adrianholovaty adrianholovaty authored
Showing with 11 additions and 6 deletions.
  1. +11 −6 docs/settings.txt
View
17 docs/settings.txt
@@ -107,15 +107,20 @@ For more, see the `diffsettings documentation`_.
Using settings in Python code
=============================
-In your Django apps, use settings by importing them from
+In your Django apps, use settings by importing the object
``django.conf.settings``. Example::
- from django.conf.settings import DEBUG
+ from django.conf import settings
- if DEBUG:
+ if settings.DEBUG:
# Do something
-Note that your code should *not* import from either ``global_settings`` or
+Note that ``django.conf.settings`` isn't a module -- it's an object. So
+importing individual settings is not possible::
+
+ from django.conf.settings import DEBUG # This won't work.
+
+Also note that your code should *not* import from either ``global_settings`` or
your own settings file. ``django.conf.settings`` abstracts the concepts of
default settings and site-specific settings; it presents a single interface.
It also decouples the code that uses settings from the location of your
@@ -127,9 +132,9 @@ Altering settings at runtime
You shouldn't alter settings in your applications at runtime. For example,
don't do this in a view::
- from django.conf.settings import DEBUG
+ from django.conf import settings
- DEBUG = True # Don't do this!
+ settings.DEBUG = True # Don't do this!
The only place you should assign to settings is in a settings file.
Please sign in to comment.
Something went wrong with that request. Please try again.