From 42e8ea9f69c133a4bbb9e496f68a05926b99c2da Mon Sep 17 00:00:00 2001 From: Raymond Hettinger Date: Sat, 3 Feb 2018 13:57:02 -0800 Subject: [PATCH] bpo-32739: Show default value for rotate() (GH-5517) Manual backport of GH-5485 --- Doc/library/collections.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst index 25e5e22fa3..a517a2eecf 100644 --- a/Doc/library/collections.rst +++ b/Doc/library/collections.rst @@ -311,11 +311,14 @@ counts, but the output will exclude results with counts of zero or less. .. versionadded:: 2.7 - .. method:: rotate(n) + .. method:: rotate(n=1) Rotate the deque *n* steps to the right. If *n* is negative, rotate to - the left. Rotating one step to the right is equivalent to: - ``d.appendleft(d.pop())``. + the left. + + When the deque is empty, rotating one step to the right is equivalent to + ``d.appendleft(d.pop())``, and rotating one step to the left is + equivalent to ``d.append(d.popleft())``. Deque objects also provide one read-only attribute: -- 2.50.1