Inconsistent documentation: refers to a "root QuerySet", which is really a Manager instance.

[julien.aubert.mail@…]

​https://docs.djangoproject.com/en/dev/topics/db/queries/#retrieving-objects

"The Manager is the main source of QuerySets for a model. It acts as a "root" QuerySet that describes all objects in the model's database table. For example, Blog.objects is the initial QuerySet that contains all Blog objects in the database."

further down

"(If Entry.objects is a QuerySet, why can't we just do Entry.objects? That's because Entry.objects, the root QuerySet, is a special case that cannot be evaluated. The all() method returns a QuerySet that can be evaluated.)"

Entry.objects is a Manager instance and not a QuerySet. To refer to a "root QuerySet" which really is a Manager instance does not help, just adds confusion. I would suggest to remove any reference to "root QuerySet" in all the doc.

[wim@…]

Accepted, agreed that we should call things by their proper names in order to avoid confusion. Thanks for the report! If you want to, you are welcome to deposit a patch.

[James Pic]

I have worked on a branch: ​https://github.com/jpic/django/tree/ticket_19717

This is the initial commit: ​https://github.com/jpic/django/commit/846def1adad702a72c6fbe0b29fc8f39c4ab05e2

And this is a pull request: ​https://github.com/django/django/pull/732

[Tim Graham <timograham@…>]

In 64d0f89ab1dc6ef8a84814f567050fc063d67de2:

Fixed #19717 - Removed mentions of "root QuerySet" in docs.

Thanks julien.aubert.mail@ for the report and James Pic for the patch.

[Tim Graham <timograham@…>]

In 5d853db90e71691f2b6b0827b002b9d0edb38fd1:

[1.5.X] Fixed #19717 - Removed mentions of "root QuerySet" in docs.

Thanks julien.aubert.mail@ for the report and James Pic for the patch.

Backport of 64d0f89ab1 from master