summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRaymond Hettinger <rhettinger@users.noreply.github.com>2019-08-22 16:11:35 (GMT)
committerGitHub <noreply@github.com>2019-08-22 16:11:35 (GMT)
commit4109263a7edce11194e301138cf66fa2d07f7ce4 (patch)
tree8768d0eaeb67cca6105b5f2910178dbbfa8a98fd
parenta38e9d139929a227e3899fbb638bc46c6cc6d8ba (diff)
downloadcpython-4109263a7edce11194e301138cf66fa2d07f7ce4.zip
cpython-4109263a7edce11194e301138cf66fa2d07f7ce4.tar.gz
cpython-4109263a7edce11194e301138cf66fa2d07f7ce4.tar.bz2
bpo-14050: Note that not all data can be sorted (GH-15381)
-rw-r--r--Doc/tutorial/datastructures.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/Doc/tutorial/datastructures.rst b/Doc/tutorial/datastructures.rst
index 01e437b..a0d5627 100644
--- a/Doc/tutorial/datastructures.rst
+++ b/Doc/tutorial/datastructures.rst
@@ -125,6 +125,13 @@ only modify the list have no return value printed -- they return the default
``None``. [1]_ This is a design principle for all mutable data structures in
Python.
+Another thing you might notice is that not all data can be sorted or
+compared. For instance, ``[None, 'hello', 10]`` doesn't sort because
+integers can't be compared to strings and *None* can't be compared to
+other types. Also, there are some types that don't have a defined
+ordering relation. For example, ``3+4j < 5+7j`` isn't a valid
+comparison.
+
.. _tut-lists-as-stacks: