Improve Scheduler Objects documentation. (GH-4556) (GH-4558)

Mention that the lower the priority number, the higher priority it represents.
(cherry picked from commit 9d5ec808de2c1359f434cc2fa8378458e4339c96)

diff --git a/Doc/library/sched.rst b/Doc/library/sched.rst
index ebe6c0a80c50cc2ddf8a04432d227bf089b2f555..1fba8ba6e519b262ca44e891e6a1a2d98a01b71e 100644 (file)
--- a/Doc/library/sched.rst
+++ b/Doc/library/sched.rst
@@ -84,7 +84,7 @@ Scheduler Objects
    Schedule a new event. The *time* argument should be a numeric type compatible
    with the return value of the *timefunc* function passed  to the constructor.
    Events scheduled for the same *time* will be executed in the order of their
-   *priority*.
+   *priority*. A lower number represents a higher priority.
 
    Executing the event means executing ``action(*argument)``.  *argument* must be a
    sequence holding the parameters for *action*.