From e37bb07bc6804b852adb6846b59f555b918b6684 Mon Sep 17 00:00:00 2001 From: Adrian Holovaty Date: Sat, 1 Jul 2006 03:31:14 +0000 Subject: [PATCH] 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 --- docs/settings.txt | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/docs/settings.txt b/docs/settings.txt index 7832569455..4f4fb70298 100644 --- a/docs/settings.txt +++ b/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.