QuerySet reference enhancement + reST cleanup
|Reported by:||Gabriel Hurley||Owned by:||Gabriel Hurley|
|Has patch:||yes||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
The reST issues aren't really the subject of this ticket (normally I'd just commit those).
However, also in this patch is a chunk that fleshes out the
QuerySet class definition. In particular it adds:
usingkwargs to the signature.
dbproperties (which are marked as "public" in the source, and are mentioned in the docs elsewhere).
using should certainly be documented as a kwarg,
sql.Query isn't a public API so I'm not sure if documenting
query is appropriate.
However, the docs say "here's the formal declaration of a QuerySet" so I'm inclined to say that the declaration should be complete.
I just wanted to get a quick nod from someone else on this one.