summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorAymeric Augustin <aymeric.augustin@m4x.org>2016-10-06 10:20:22 -0400
committerTim Graham <timograham@gmail.com>2016-10-06 10:21:57 -0400
commit5d35181de4a9d693c4702680974b30db3035a0c9 (patch)
treeeb736229be9e0038c1e9fc69ea43a6624e5ccf89 /docs/ref
parent979ea95608176e9c88678fd4d8a096c29654b5f3 (diff)
Documented AppRegistryNotReady.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/applications.txt8
-rw-r--r--docs/ref/exceptions.txt9
2 files changed, 14 insertions, 3 deletions
diff --git a/docs/ref/applications.txt b/docs/ref/applications.txt
index 2340951542..0811bdf75f 100644
--- a/docs/ref/applications.txt
+++ b/docs/ref/applications.txt
@@ -347,6 +347,8 @@ Application registry
:exc:`ValueError` when called with a single argument that doesn't contain
exactly one dot.
+.. _app-loading-process:
+
Initialization process
======================
@@ -425,9 +427,9 @@ Troubleshooting
Here are some common problems that you may encounter during initialization:
-* ``AppRegistryNotReady`` This happens when importing an application
- configuration or a models module triggers code that depends on the app
- registry.
+* :class:`~django.core.exceptions.AppRegistryNotReady`: This happens when
+ importing an application configuration or a models module triggers code that
+ depends on the app registry.
For example, :func:`~django.utils.translation.ugettext()` uses the app
registry to look up translation catalogs in applications. To translate at
diff --git a/docs/ref/exceptions.txt b/docs/ref/exceptions.txt
index 8c05aca977..6ce52977e8 100644
--- a/docs/ref/exceptions.txt
+++ b/docs/ref/exceptions.txt
@@ -12,6 +12,15 @@ Django Core Exceptions
Django core exception classes are defined in ``django.core.exceptions``.
+``AppRegistryNotReady``
+-----------------------
+
+.. exception:: AppRegistryNotReady
+
+ This exception is raised when attempting to use models before the :ref:`app
+ loading process <app-loading-process>`, which initializes the ORM, is
+ complete.
+
``ObjectDoesNotExist``
----------------------