Docs wordsmithing about Range order

This commit is contained in:
Daniele Varrazzo 2014-02-22 21:56:46 +00:00
parent 8937c635df
commit 212f4e3538

View File

@ -437,14 +437,17 @@ user-defined |range| types can be adapted using `register_range()`.
`!Range` objects are immutable, hashable, and support the ``in`` operator
(checking if an element is within the range). They can be tested for
equivalence. Empty ranges evaluate to `!False` in
boolean context, nonempty evaluate to `!True`.
`!Range` objects can be sorted although, as on the server-side,
this ordering is not particularly meangingful.
equivalence. Empty ranges evaluate to `!False` in boolean context,
nonempty evaluate to `!True`.
.. versionchanged:: 2.5.3
`!Range` objects can be sorted although, as on the server-side, this
ordering is not particularly meangingful. It is only meant to be used
by programs assuming objects using `!Range` as primary key can be
sorted on them. In previous versions comparing `!Range`\s raises
`!TypeError`.
Although it is possible to instantiate `!Range` objects, the class doesn't
have an adapter registered, so you cannot normally pass these instances as
query arguments. To use range objects as query arguments you can either