Issue #24952: Clarify default argument of stack_size() in threading, _thread

Patch from Mattip.

diff --git a/Doc/library/_thread.rst b/Doc/library/_thread.rst
index a787e2fd4b79f99816d332d70b83d45b9ec92b80..7122861c4517b8c2218f3147005a2dde35a4993a 100644 (file)
--- a/Doc/library/_thread.rst
+++ b/Doc/library/_thread.rst
@@ -93,7 +93,8 @@ It defines the following constants and functions:
    Return the thread stack size used when creating new threads.  The optional
    *size* argument specifies the stack size to be used for subsequently created
    threads, and must be 0 (use platform or configured default) or a positive
-   integer value of at least 32,768 (32 KiB). If changing the thread stack size is
+   integer value of at least 32,768 (32 KiB). If *size* is not specified,
+   0 is used.  If changing the thread stack size is
    unsupported, a :exc:`RuntimeError` is raised.  If the specified stack size is
    invalid, a :exc:`ValueError` is raised and the stack size is unmodified.  32 KiB
    is currently the minimum supported stack size value to guarantee sufficient

diff --git a/Doc/library/threading.rst b/Doc/library/threading.rst
index 5269994781c6296d4a2d4bc3bba4c49f7d5450a4..c56d70734238556cdc163ca4de6c1ab73c7a1b0a 100644 (file)
--- a/Doc/library/threading.rst
+++ b/Doc/library/threading.rst
@@ -89,7 +89,8 @@ This module defines the following functions:
    Return the thread stack size used when creating new threads.  The optional
    *size* argument specifies the stack size to be used for subsequently created
    threads, and must be 0 (use platform or configured default) or a positive
-   integer value of at least 32,768 (32 KiB). If changing the thread stack size is
+   integer value of at least 32,768 (32 KiB). If *size* is not specified,
+   0 is used.  If changing the thread stack size is
    unsupported, a :exc:`RuntimeError` is raised.  If the specified stack size is
    invalid, a :exc:`ValueError` is raised and the stack size is unmodified.  32 KiB
    is currently the minimum supported stack size value to guarantee sufficient

diff --git a/Misc/ACKS b/Misc/ACKS
index 8ab9f7765c80b95ca11fad37f796eb6fb39ebfa2..9af7c98f040e33db990d5318a09690ff0f3d0a7d 100644 (file)
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -888,6 +888,7 @@ Nick Mathewson
 Simon Mathieu
 Laura Matson
 Graham Matthews
+mattip
 Martin Matusiak
 Dieter Maurer
 Daniel May

diff --git a/Misc/NEWS b/Misc/NEWS
index 0b464518373b7759151a36eebfba2891dd80536a..02040903041807c0098e94a446673c603598d6bb 100644 (file)
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -456,6 +456,9 @@ C API
 Documentation
 -------------
 
+- Issue #24952: Clarify the default size argument of stack_size() in
+  the "threading" and "_thread" modules. Patch from Mattip.
+
 - Issue #24808: Update the types of some PyTypeObject fields. Patch by
   Joseph Weston.