From 31e7f50d4cb756927a89d2d33eaf1b5a030be7a9 Mon Sep 17 00:00:00 2001 From: Martin Panter Date: Mon, 31 Aug 2015 03:15:52 +0000 Subject: Issue #24952: Clarify default argument of stack_size() in threading, _thread Patch from Mattip. --- Doc/library/_thread.rst | 3 ++- Doc/library/threading.rst | 3 ++- Misc/ACKS | 1 + Misc/NEWS | 3 +++ 4 files changed, 8 insertions(+), 2 deletions(-) diff --git a/Doc/library/_thread.rst b/Doc/library/_thread.rst index a787e2f..7122861 100644 --- 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 5269994..c56d707 100644 --- 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 8ab9f77..9af7c98 100644 --- 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 0b46451..0204090 100644 --- 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. -- cgit v0.12