fix #1437: return pids() in sorted order

1 files changed, 6 insertions, 2 deletions

diff --git a/docs/index.rst b/docs/index.rst
index 8983e880..a6f2ba73 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -817,13 +817,17 @@ Functions
 
 .. function:: pids()
 
-  Return a list of current running PIDs. To iterate over all processes
-  and avoid race conditions :func:`process_iter()` should be preferred.
+  Return a sorted list of current running PIDs.
+  To iterate over all processes and avoid race conditions :func:`process_iter()`
+  should be preferred.
 
   >>> import psutil
   >>> psutil.pids()
   [1, 2, 3, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 17, 18, 19, ..., 32498]
 
+  .. versionchanged::
+    5.6.0 PIDs are returned in sorted order
+
 .. function:: process_iter(attrs=None, ad_value=None)
 
   Return an iterator yielding a :class:`Process` class instance for all running