[Python-checkins] GH-101777: `queue.rst`: use 2 spaces after a period to be consistent. (GH-102143)

miss-islington webhook-mailer at python.org
Wed Feb 22 16:39:12 EST 2023


https://github.com/python/cpython/commit/8b5498e36795d2d17c0673cfa8831cb052ec7a0a
commit: 8b5498e36795d2d17c0673cfa8831cb052ec7a0a
branch: 3.11
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2023-02-22T13:39:05-08:00
summary:

GH-101777: `queue.rst`: use 2 spaces after a period to be consistent. (GH-102143)

(cherry picked from commit 96bf24380e44dfa1516d65480250995e737c0cb9)

Co-authored-by: Owain Davies <116417456+OTheDev at users.noreply.github.com>

files:
M Doc/library/queue.rst

diff --git a/Doc/library/queue.rst b/Doc/library/queue.rst
index 46b8e9b18a3c..b2b787c5a826 100644
--- a/Doc/library/queue.rst
+++ b/Doc/library/queue.rst
@@ -15,7 +15,7 @@ module implements all the required locking semantics.
 
 The module implements three types of queue, which differ only in the order in
 which the entries are retrieved.  In a :abbr:`FIFO (first-in, first-out)`
-queue, the first tasks added are the first retrieved. In a
+queue, the first tasks added are the first retrieved.  In a
 :abbr:`LIFO (last-in, first-out)` queue, the most recently added entry is
 the first retrieved (operating like a stack).  With a priority queue,
 the entries are kept sorted (using the :mod:`heapq` module) and the
@@ -57,7 +57,7 @@ The :mod:`queue` module defines the following classes and exceptions:
    *maxsize* is less than or equal to zero, the queue size is infinite.
 
    The lowest valued entries are retrieved first (the lowest valued entry is the
-   one that would be returned by ``min(entries)``). A typical pattern for
+   one that would be returned by ``min(entries)``).  A typical pattern for
    entries is a tuple in the form: ``(priority_number, data)``.
 
    If the *data* elements are not comparable, the data can be wrapped in a class
@@ -127,8 +127,8 @@ provide the public methods described below.
 
 .. method:: Queue.put(item, block=True, timeout=None)
 
-   Put *item* into the queue. If optional args *block* is true and *timeout* is
-   ``None`` (the default), block if necessary until a free slot is available. If
+   Put *item* into the queue.  If optional args *block* is true and *timeout* is
+   ``None`` (the default), block if necessary until a free slot is available.  If
    *timeout* is a positive number, it blocks at most *timeout* seconds and raises
    the :exc:`Full` exception if no free slot was available within that time.
    Otherwise (*block* is false), put an item on the queue if a free slot is
@@ -143,7 +143,7 @@ provide the public methods described below.
 
 .. method:: Queue.get(block=True, timeout=None)
 
-   Remove and return an item from the queue. If optional args *block* is true and
+   Remove and return an item from the queue.  If optional args *block* is true and
    *timeout* is ``None`` (the default), block if necessary until an item is available.
    If *timeout* is a positive number, it blocks at most *timeout* seconds and
    raises the :exc:`Empty` exception if no item was available within that time.
@@ -152,7 +152,7 @@ provide the public methods described below.
 
    Prior to 3.0 on POSIX systems, and for all versions on Windows, if
    *block* is true and *timeout* is ``None``, this operation goes into
-   an uninterruptible wait on an underlying lock. This means that no exceptions
+   an uninterruptible wait on an underlying lock.  This means that no exceptions
    can occur, and in particular a SIGINT will not trigger a :exc:`KeyboardInterrupt`.
 
 
@@ -184,7 +184,7 @@ fully processed by daemon consumer threads.
 
    The count of unfinished tasks goes up whenever an item is added to the queue.
    The count goes down whenever a consumer thread calls :meth:`task_done` to
-   indicate that the item was retrieved and all work on it is complete. When the
+   indicate that the item was retrieved and all work on it is complete.  When the
    count of unfinished tasks drops to zero, :meth:`join` unblocks.
 
 
@@ -227,7 +227,7 @@ SimpleQueue Objects
 
 .. method:: SimpleQueue.empty()
 
-   Return ``True`` if the queue is empty, ``False`` otherwise. If empty()
+   Return ``True`` if the queue is empty, ``False`` otherwise.  If empty()
    returns ``False`` it doesn't guarantee that a subsequent call to get()
    will not block.
 



More information about the Python-checkins mailing list