diff options
Diffstat (limited to 'docs/ref')
| -rw-r--r-- | docs/ref/applications.txt | 8 | ||||
| -rw-r--r-- | docs/ref/exceptions.txt | 9 |
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 c222010172..690b403142 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`` ---------------------- |