Error in F() object docs

[Erik Wognsen]

​http://docs.djangoproject.com/en/dev/topics/db/queries/#filters-can-reference-fields-on-the-model says:

"To find all the blog entries with twice as many comments as pingbacks, we modify the query:"

>>> Entry.objects.filter(n_pingbacks__lt=F('n_comments') * 2)

But the query should in fact have been:

>>> Entry.objects.filter(n_pingbacks=F('n_comments') / 2)

And to find entries with at least twice as many comments as pingbacks:

>>> Entry.objects.filter(n_pingbacks__lte=F('n_comments') / 2)

It would probably be easier to understand the sentences where comments come before pingbacks ("twice as many comments as pingbacks"), if they had the same order in the query. Again, to find entries with at least twice as many comments as pingbacks:

>>> Entry.objects.filter(n_comments__gte=F('n_pingbacks') * 2)

[Erik Wognsen]

I think this patch fixes the problem and makes F() objects a bit easier to understand by using gt instead of lt.

[Russell Keith-Magee]

(In [13254]) Fixed #13532 -- Corrected and clarified examples in F() docs. Thanks to erw for the report and patch.

[Russell Keith-Magee]

(In [13255]) [1.1.X] Fixed #13532 -- Corrected and clarified examples in F() docs. Thanks to erw for the report and patch.

Backport of r13254 from trunk.

[Jacob]

Milestone 1.2 deleted