diff options
| author | Kevin Christopher Henry <k@severian.com> | 2013-12-18 00:40:25 -0500 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2013-12-18 12:37:11 -0500 |
| commit | d34c8c338a843df2a540f19d15efc1ff12e3119c (patch) | |
| tree | 41a58031d8744d2b7cc266ba3e87c7b172f20552 /docs | |
| parent | d4e578d0f64971483ded49f9cae460ea174b5138 (diff) | |
Fixed #21632 -- Docs: Removed example with callable as query parameter
Using callables as query parameters is undocumented and not working,
so this changes an example from the ForeignKey.limit_choices_to
documentation that uses it.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/models/fields.txt | 11 |
1 files changed, 5 insertions, 6 deletions
diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index 20e0975c18..cc2a4cdcf4 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -1068,14 +1068,13 @@ define the details of how the relation works. .. attribute:: ForeignKey.limit_choices_to A dictionary of lookup arguments and values (see :doc:`/topics/db/queries`) - that limit the available admin or ModelForm choices for this object. Use - this with functions from the Python ``datetime`` module to limit choices of - objects by date. For example:: + that limit the available admin or :class:`ModelForm <django.forms.ModelForm>` + choices for this object. For example:: - limit_choices_to = {'pub_date__lte': datetime.date.today} + staff_member = models.ForeignKey(User, limit_choices_to={'is_staff': True}) - only allows the choice of related objects with a ``pub_date`` before the - current date to be chosen. + causes the corresponding field on the ``ModelForm`` to list only ``Users`` + that have ``is_staff=True``. Instead of a dictionary this can also be a :class:`Q object <django.db.models.Q>` for more :ref:`complex queries |
