Kaydet (Commit) 8ce8beb3 authored tarafından Tim Graham's avatar Tim Graham

Unified some doc links to OneToOneField and ManyToManyField.

üst a6ef025d
...@@ -1386,8 +1386,6 @@ The possible values for :attr:`~ForeignKey.on_delete` are found in ...@@ -1386,8 +1386,6 @@ The possible values for :attr:`~ForeignKey.on_delete` are found in
If in doubt, leave it to its default of ``True``. If in doubt, leave it to its default of ``True``.
.. _ref-manytomany:
``ManyToManyField`` ``ManyToManyField``
------------------- -------------------
...@@ -1591,8 +1589,6 @@ that control how the relationship functions. ...@@ -1591,8 +1589,6 @@ that control how the relationship functions.
:attr:`~Field.null` has no effect since there is no way to require a :attr:`~Field.null` has no effect since there is no way to require a
relationship at the database level. relationship at the database level.
.. _ref-onetoone:
``OneToOneField`` ``OneToOneField``
----------------- -----------------
......
...@@ -76,8 +76,8 @@ but a few of the key features are: ...@@ -76,8 +76,8 @@ but a few of the key features are:
<test-case-serialized-rollback>`. <test-case-serialized-rollback>`.
* It is not advised to have apps without migrations depend on (have a * It is not advised to have apps without migrations depend on (have a
:ref:`ForeignKey <ref-foreignkey>` or :ref:`ManyToManyField <ref-manytomany>` :class:`~django.db.models.ForeignKey` or
to) apps with migrations. :class:`~django.db.models.ManyToManyField` to) apps with migrations.
.. _app-loading-refactor-17-release-note: .. _app-loading-refactor-17-release-note:
......
...@@ -300,8 +300,8 @@ change to what is stored in the database, you can create a :ref:`proxy model ...@@ -300,8 +300,8 @@ change to what is stored in the database, you can create a :ref:`proxy model
allows for any of the features offered by proxy models including default allows for any of the features offered by proxy models including default
ordering, custom managers, or custom model methods. ordering, custom managers, or custom model methods.
If you wish to store information related to ``User``, you can use a :ref:`one-to-one If you wish to store information related to ``User``, you can use a
relationship <ref-onetoone>` to a model containing the fields for :class:`~django.db.models.OneToOneField` to a model containing the fields for
additional information. This one-to-one model is often called a profile model, additional information. This one-to-one model is often called a profile model,
as it might store non-auth related information about a site user. For example as it might store non-auth related information about a site user. For example
you might create an Employee model:: you might create an Employee model::
......
...@@ -4,7 +4,8 @@ Many-to-many relationships ...@@ -4,7 +4,8 @@ Many-to-many relationships
.. highlight:: pycon .. highlight:: pycon
To define a many-to-many relationship, use :ref:`ref-manytomany`. To define a many-to-many relationship, use
:class:`~django.db.models.ManyToManyField`.
In this example, an ``Article`` can be published in multiple ``Publication`` In this example, an ``Article`` can be published in multiple ``Publication``
objects, and a ``Publication`` has multiple ``Article`` objects: objects, and a ``Publication`` has multiple ``Article`` objects:
......
...@@ -2,7 +2,8 @@ ...@@ -2,7 +2,8 @@
One-to-one relationships One-to-one relationships
======================== ========================
To define a one-to-one relationship, use :ref:`ref-onetoone`. To define a one-to-one relationship, use
:class:`~django.db.models.OneToOneField`.
In this example, a ``Place`` optionally can be a ``Restaurant``:: In this example, a ``Place`` optionally can be a ``Restaurant``::
......
...@@ -387,8 +387,7 @@ For example, if a ``Pizza`` has multiple ``Topping`` objects -- that is, a ...@@ -387,8 +387,7 @@ For example, if a ``Pizza`` has multiple ``Topping`` objects -- that is, a
As with :class:`~django.db.models.ForeignKey`, you can also create As with :class:`~django.db.models.ForeignKey`, you can also create
:ref:`recursive relationships <recursive-relationships>` (an object with a :ref:`recursive relationships <recursive-relationships>` (an object with a
many-to-many relationship to itself) and :ref:`relationships to models not yet many-to-many relationship to itself) and :ref:`relationships to models not yet
defined <lazy-relationships>`; see :ref:`the model field reference defined <lazy-relationships>`.
<ref-manytomany>` for details.
It's suggested, but not required, that the name of a It's suggested, but not required, that the name of a
:class:`~django.db.models.ManyToManyField` (``toppings`` in the example above) :class:`~django.db.models.ManyToManyField` (``toppings`` in the example above)
...@@ -610,20 +609,17 @@ restaurant "is a" place; in fact, to handle this you'd typically use ...@@ -610,20 +609,17 @@ restaurant "is a" place; in fact, to handle this you'd typically use
:ref:`inheritance <model-inheritance>`, which involves an implicit :ref:`inheritance <model-inheritance>`, which involves an implicit
one-to-one relation). one-to-one relation).
As with :class:`~django.db.models.ForeignKey`, a As with :class:`~django.db.models.ForeignKey`, a :ref:`recursive relationship
:ref:`recursive relationship <recursive-relationships>` <recursive-relationships>` can be defined and :ref:`references to as-yet
can be defined and undefined models <lazy-relationships>` can be made.
:ref:`references to as-yet undefined models <lazy-relationships>`
can be made; see :ref:`the model field reference <ref-onetoone>` for details.
.. seealso:: .. seealso::
See the :doc:`One-to-one relationship model example See the :doc:`One-to-one relationship model example
</topics/db/examples/one_to_one>` for a full example. </topics/db/examples/one_to_one>` for a full example.
:class:`~django.db.models.OneToOneField` fields also accept one specific, :class:`~django.db.models.OneToOneField` fields also accept an optional
optional ``parent_link`` argument described in the :ref:`model field :attr:`~django.db.models.OneToOneField.parent_link` argument.
reference <ref-onetoone>`.
:class:`~django.db.models.OneToOneField` classes used to automatically become :class:`~django.db.models.OneToOneField` classes used to automatically become
the primary key on a model. This is no longer true (although you can manually the primary key on a model. This is no longer true (although you can manually
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment