Corrected a number of mislinked crossrefs and added a few new crossref targets found in/via the 1.3 release.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@15894 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
parent
16f4a2bec2
commit
a4ef094b0f
|
@ -25,7 +25,7 @@ ObjectDoesNotExist and DoesNotExist
|
||||||
exception that is provided on every model class as a way of
|
exception that is provided on every model class as a way of
|
||||||
identifying the specific type of object that could not be found.
|
identifying the specific type of object that could not be found.
|
||||||
|
|
||||||
See :meth:`~django.db.models.QuerySet.get()` for further information
|
See :meth:`~django.db.models.query.QuerySet.get()` for further information
|
||||||
on :exc:`ObjectDoesNotExist` and :exc:`DoesNotExist`.
|
on :exc:`ObjectDoesNotExist` and :exc:`DoesNotExist`.
|
||||||
|
|
||||||
MultipleObjectsReturned
|
MultipleObjectsReturned
|
||||||
|
@ -38,7 +38,7 @@ MultipleObjectsReturned
|
||||||
class contains a subclassed version that can be used to identify the
|
class contains a subclassed version that can be used to identify the
|
||||||
specific object type that has returned multiple objects.
|
specific object type that has returned multiple objects.
|
||||||
|
|
||||||
See :meth:`~django.db.models.QuerySet.get()` for further information.
|
See :meth:`~django.db.models.query.QuerySet.get()` for further information.
|
||||||
|
|
||||||
SuspiciousOperation
|
SuspiciousOperation
|
||||||
-------------------
|
-------------------
|
||||||
|
@ -133,6 +133,17 @@ Specification v2.0`_ for further information.
|
||||||
|
|
||||||
.. _`PEP 249 - Python Database API Specification v2.0`: http://www.python.org/dev/peps/pep-0249/
|
.. _`PEP 249 - Python Database API Specification v2.0`: http://www.python.org/dev/peps/pep-0249/
|
||||||
|
|
||||||
|
.. currentmodule:: django.db.transaction
|
||||||
|
|
||||||
|
Transaction Exceptions
|
||||||
|
======================
|
||||||
|
|
||||||
|
.. exception:: TransactionManagementError
|
||||||
|
|
||||||
|
The :exc:`TransactionManagementError` is raised for any and all problems
|
||||||
|
related to database transactions. It is available from
|
||||||
|
:mod:`django.db.transaction`.
|
||||||
|
|
||||||
Python Exceptions
|
Python Exceptions
|
||||||
=================
|
=================
|
||||||
|
|
||||||
|
|
|
@ -29,6 +29,8 @@ Most generic views require the ``queryset`` key, which is a ``QuerySet``
|
||||||
instance; see :doc:`/topics/db/queries` for more information about ``QuerySet``
|
instance; see :doc:`/topics/db/queries` for more information about ``QuerySet``
|
||||||
objects.
|
objects.
|
||||||
|
|
||||||
|
.. module:: django.views.generic.simple
|
||||||
|
|
||||||
"Simple" generic views
|
"Simple" generic views
|
||||||
======================
|
======================
|
||||||
|
|
||||||
|
@ -146,6 +148,8 @@ string is written as ``"%7Ejacob/"`` (with only a single ``%``), an exception wo
|
||||||
('^bar/$', redirect_to, {'url': '%%7Ejacob.'}),
|
('^bar/$', redirect_to, {'url': '%%7Ejacob.'}),
|
||||||
)
|
)
|
||||||
|
|
||||||
|
.. module:: django.views.generic.date_based
|
||||||
|
|
||||||
Date-based generic views
|
Date-based generic views
|
||||||
========================
|
========================
|
||||||
|
|
||||||
|
@ -677,6 +681,8 @@ In addition to ``extra_context``, the template's context will be:
|
||||||
``template_object_name`` is ``'foo'``, this variable's name will be
|
``template_object_name`` is ``'foo'``, this variable's name will be
|
||||||
``foo``.
|
``foo``.
|
||||||
|
|
||||||
|
.. module:: django.views.generic.list_detail
|
||||||
|
|
||||||
List/detail generic views
|
List/detail generic views
|
||||||
=========================
|
=========================
|
||||||
|
|
||||||
|
@ -862,6 +868,8 @@ In addition to ``extra_context``, the template's context will be:
|
||||||
``template_object_name`` is ``'foo'``, this variable's name will be
|
``template_object_name`` is ``'foo'``, this variable's name will be
|
||||||
``foo``.
|
``foo``.
|
||||||
|
|
||||||
|
.. module:: django.views.generic.create_update
|
||||||
|
|
||||||
Create/update/delete generic views
|
Create/update/delete generic views
|
||||||
==================================
|
==================================
|
||||||
|
|
||||||
|
|
|
@ -197,15 +197,15 @@ additional data into the context.
|
||||||
However, you can't (easily) modify the content of a basic
|
However, you can't (easily) modify the content of a basic
|
||||||
:class:`~django.http.HttpResponse` after it has been constructed. To
|
:class:`~django.http.HttpResponse` after it has been constructed. To
|
||||||
overcome this limitation, Django 1.3 adds a new
|
overcome this limitation, Django 1.3 adds a new
|
||||||
:class:`~django.template.TemplateResponse` class. Unlike basic
|
:class:`~django.template.response.TemplateResponse` class. Unlike basic
|
||||||
:class:`~django.http.HttpResponse` objects,
|
:class:`~django.http.HttpResponse` objects,
|
||||||
:class:`~django.template.TemplateResponse` objects retain the details
|
:class:`~django.template.response.TemplateResponse` objects retain the details
|
||||||
of the template and context that was provided by the view to compute
|
of the template and context that was provided by the view to compute
|
||||||
the response. The final output of the response is not computed until
|
the response. The final output of the response is not computed until
|
||||||
it is needed, later in the response process.
|
it is needed, later in the response process.
|
||||||
|
|
||||||
For more details, see the :doc:`documentation </ref/template-response>`
|
For more details, see the :doc:`documentation </ref/template-response>`
|
||||||
on the :class:`~django.template.TemplateResponse` class.
|
on the :class:`~django.template.response.TemplateResponse` class.
|
||||||
|
|
||||||
Caching changes
|
Caching changes
|
||||||
~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~
|
||||||
|
@ -253,11 +253,11 @@ when using :ref:`spatial database backends <spatial-backends>`.
|
||||||
``MEDIA_URL`` and ``STATIC_URL`` must end in a slash
|
``MEDIA_URL`` and ``STATIC_URL`` must end in a slash
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
Previously, the ``MEDIA_URL`` setting only required a trailing slash if it
|
Previously, the :setting:`MEDIA_URL` setting only required a trailing slash if
|
||||||
contained a suffix beyond the domain name.
|
it contained a suffix beyond the domain name.
|
||||||
|
|
||||||
A trailing slash is now *required* for ``MEDIA_URL`` and the new
|
A trailing slash is now *required* for :setting:`MEDIA_URL` and the new
|
||||||
``STATIC_URL`` setting as long as it is not blank. This ensures there is
|
:setting:`STATIC_URL` setting as long as it is not blank. This ensures there is
|
||||||
a consistent way to combine paths in templates.
|
a consistent way to combine paths in templates.
|
||||||
|
|
||||||
Project settings which provide either of both settings without a trailing
|
Project settings which provide either of both settings without a trailing
|
||||||
|
@ -279,31 +279,34 @@ To compensate for this, the focus of the Django 1.3 development
|
||||||
process has been on adding lots of smaller, long standing feature
|
process has been on adding lots of smaller, long standing feature
|
||||||
requests. These include:
|
requests. These include:
|
||||||
|
|
||||||
* Improved tools for accessing and manipulating the current ``Site``
|
* Improved tools for accessing and manipulating the current
|
||||||
object in :doc:`the sites framework </ref/contrib/sites>`.
|
:class:`~django.contrib.sites.models.Site` object in
|
||||||
|
:doc:`the sites framework </ref/contrib/sites>`.
|
||||||
|
|
||||||
* A :class:`~django.test.client.RequestFactory` for mocking requests
|
* A :class:`~django.test.client.RequestFactory` for mocking requests
|
||||||
in tests.
|
in tests.
|
||||||
|
|
||||||
* A new test assertion --
|
* A new test assertion --
|
||||||
:meth:`~django.test.client.Client.assertNumQueries` -- making it
|
:meth:`~django.test.TestCase.assertNumQueries` -- making it
|
||||||
easier to test the database activity associated with a view.
|
easier to test the database activity associated with a view.
|
||||||
|
|
||||||
* Support for lookups spanning relations in admin's ``list_filter``.
|
* Support for lookups spanning relations in admin's
|
||||||
|
:attr:`~django.contrib.admin.ModelAdmin.list_filter`.
|
||||||
|
|
||||||
* Support for _HTTPOnly cookies.
|
* Support for HTTPOnly_ cookies.
|
||||||
|
|
||||||
* :meth:`mail_admins()` and :meth:`mail_managers()` now support
|
* :meth:`~django.core.mail.mail_admins()` and
|
||||||
easily attaching HTML content to messages.
|
:meth:`~django.core.mail.mail_managers()` now support easily attaching
|
||||||
|
HTML content to messages.
|
||||||
|
|
||||||
* :class:`EmailMessage` now supports CC's.
|
* :class:`~django.core.mail.EmailMessage` now supports CC's.
|
||||||
|
|
||||||
* Error emails now include more of the detail and formatting of the
|
* Error emails now include more of the detail and formatting of the
|
||||||
debug server error page.
|
debug server error page.
|
||||||
|
|
||||||
* :meth:`simple_tag` now accepts a :attr:`takes_context` argument,
|
* :meth:`~django.template.Library.simple_tag` now accepts a
|
||||||
making it easier to write simple template tags that require access
|
``takes_context`` argument, making it easier to write simple
|
||||||
to template context.
|
template tags that require access to template context.
|
||||||
|
|
||||||
* A new :meth:`~django.shortcuts.render()` shortcut -- an alternative
|
* A new :meth:`~django.shortcuts.render()` shortcut -- an alternative
|
||||||
to :meth:`~django.shortcuts.render_to_response()` providing a
|
to :meth:`~django.shortcuts.render_to_response()` providing a
|
||||||
|
@ -381,10 +384,11 @@ explicitly indicate this. For example::
|
||||||
Clearable default widget for FileField
|
Clearable default widget for FileField
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
Django 1.3 now includes a ``ClearableFileInput`` form widget in addition to
|
Django 1.3 now includes a :class:`~django.forms.ClearableFileInput` form widget
|
||||||
``FileInput``. ``ClearableFileInput`` renders with a checkbox to clear the
|
in addition to :class:`~django.forms.FileInput`. ``ClearableFileInput`` renders
|
||||||
field's value (if the field has a value and is not required); ``FileInput``
|
with a checkbox to clear the field's value (if the field has a value and is not
|
||||||
provided no means for clearing an existing file from a ``FileField``.
|
required); ``FileInput`` provided no means for clearing an existing file from
|
||||||
|
a ``FileField``.
|
||||||
|
|
||||||
``ClearableFileInput`` is now the default widget for a ``FileField``, so
|
``ClearableFileInput`` is now the default widget for a ``FileField``, so
|
||||||
existing forms including ``FileField`` without assigning a custom widget will
|
existing forms including ``FileField`` without assigning a custom widget will
|
||||||
|
@ -437,7 +441,7 @@ of a web framework, we have "fixed" the problem by making the list of
|
||||||
prohibited words an empty list.
|
prohibited words an empty list.
|
||||||
|
|
||||||
If you want to restore the old behavior, simply put a
|
If you want to restore the old behavior, simply put a
|
||||||
``PROFANITIES_LIST`` setting in your settings file that includes the
|
:setting:`PROFANITIES_LIST` setting in your settings file that includes the
|
||||||
words that you want to prohibit (see the `commit that implemented this
|
words that you want to prohibit (see the `commit that implemented this
|
||||||
change`_ if you want to see the list of words that was historically
|
change`_ if you want to see the list of words that was historically
|
||||||
prohibited). However, if avoiding profanities is important to you, you
|
prohibited). However, if avoiding profanities is important to you, you
|
||||||
|
@ -622,7 +626,8 @@ transactions that are being managed using
|
||||||
return render_to_response('template', {'object':obj})
|
return render_to_response('template', {'object':obj})
|
||||||
|
|
||||||
Prior to Django 1.3, this would work without error. However, under
|
Prior to Django 1.3, this would work without error. However, under
|
||||||
Django 1.3, this will raise a :class:`TransactionManagementError` because
|
Django 1.3, this will raise a
|
||||||
|
:class:`~django.db.transaction.TransactionManagementError` because
|
||||||
the read operation that retrieves the ``MyObject`` instance leaves the
|
the read operation that retrieves the ``MyObject`` instance leaves the
|
||||||
transaction in a dirty state.
|
transaction in a dirty state.
|
||||||
|
|
||||||
|
@ -868,12 +873,12 @@ identical to their old versions; only the module location has changed.
|
||||||
Removal of ``XMLField``
|
Removal of ``XMLField``
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
When Django was first released, Django included an ``XMLField`` that
|
When Django was first released, Django included an
|
||||||
performed automatic XML validation for any field input. However, this
|
:class:`~django.db.models.XMLField` that performed automatic XML validation
|
||||||
validation function hasn't been performed since the introduction of
|
for any field input. However, this validation function hasn't been
|
||||||
``newforms``, prior to the 1.0 release. As a result, ``XMLField`` as
|
performed since the introduction of ``newforms``, prior to the 1.0 release.
|
||||||
currently implemented is functionally indistinguishable from a simple
|
As a result, ``XMLField`` as currently implemented is functionally
|
||||||
``TextField``.
|
indistinguishable from a simple :class:`~django.db.models.TextField`.
|
||||||
|
|
||||||
For this reason, Django 1.3 has fast-tracked the deprecation of
|
For this reason, Django 1.3 has fast-tracked the deprecation of
|
||||||
``XMLField`` -- instead of a two-release deprecation, ``XMLField``
|
``XMLField`` -- instead of a two-release deprecation, ``XMLField``
|
||||||
|
|
|
@ -2,7 +2,7 @@
|
||||||
Managing database transactions
|
Managing database transactions
|
||||||
==============================
|
==============================
|
||||||
|
|
||||||
.. currentmodule:: django.db.transaction
|
.. module:: django.db.transaction
|
||||||
|
|
||||||
Django gives you a few ways to control how database transactions are managed,
|
Django gives you a few ways to control how database transactions are managed,
|
||||||
if you're using a database that supports transactions.
|
if you're using a database that supports transactions.
|
||||||
|
|
Loading…
Reference in New Issue