From 08b4a22293ca237e4fc6900c876241ca60941393 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Anssi=20K=C3=A4=C3=A4ri=C3=A4inen?= Date: Sat, 24 Nov 2012 16:19:55 +0200 Subject: [PATCH] Updated stale docstring of setup_joins --- django/db/models/sql/query.py | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/django/db/models/sql/query.py b/django/db/models/sql/query.py index b03465b402..9c2e140225 100644 --- a/django/db/models/sql/query.py +++ b/django/db/models/sql/query.py @@ -1274,11 +1274,17 @@ class Query(object): Compute the necessary table joins for the passage through the fields given in 'names'. 'opts' is the Options class for the current model (which gives the table we are joining to), 'alias' is the alias for the - table we are joining to. If dupe_multis is True, any many-to-many or - many-to-one joins will always create a new alias (necessary for - disjunctive filters). If can_reuse is not None, it's a list of aliases - that can be reused in these joins (nothing else can be reused in this - case). Finally, 'negate' is used in the same sense as for add_filter() + table we are joining to. + + The 'can_reuse' defines the reverse foreign key joins we can reuse. It + can be either sql.constants.REUSE_ALL in which case all joins are + reusable or a set of aliases that can be reused. Non-reverse foreign + keys are always reusable. + + The 'allow_explicit_fk' controls if field.attname is allowed in the + lookups. + + Finally, 'negate' is used in the same sense as for add_filter() -- it indicates an exclude() filter, or something similar. It is only passed in here so that it can be passed to a field's extra_filter() for customized behavior.