summaryrefslogtreecommitdiff
path: root/docs/settings.txt
diff options
context:
space:
mode:
authorMalcolm Tredinnick <malcolm.tredinnick@gmail.com>2006-05-17 06:57:22 +0000
committerMalcolm Tredinnick <malcolm.tredinnick@gmail.com>2006-05-17 06:57:22 +0000
commit390231d4068a550ef8188807c6e7e7b2f0fb1521 (patch)
treeda7c4df7c55a5472ec258ba06247792fe70abe49 /docs/settings.txt
parenteb707d8c4380b0423232dc8462f5b215fbfa2286 (diff)
Clarified (hopefully) how to use the default settings override in configure().
git-svn-id: http://code.djangoproject.com/svn/django/trunk@2932 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs/settings.txt')
-rw-r--r--docs/settings.txt7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/settings.txt b/docs/settings.txt
index f027d5596b..766f26edbb 100644
--- a/docs/settings.txt
+++ b/docs/settings.txt
@@ -771,6 +771,13 @@ is equivalent::
settings.configure(myapp_defaults, DEBUG = True)
+Normally, you will not need to override the defaults in this fashion. The
+Django defaults are sufficiently tame that you can safely use them. Be aware
+that if you do pass in a new default module, it entirely *replaces* the Django
+defaults, so you must specify a value for every possible setting that might be
+used in that code you are importing. Check in
+``django.conf.settings.global_settings`` for the full list.
+
Either configure() or DJANGO_SETTINGS_MODULE is required
--------------------------------------------------------