From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 21 Feb 2020 06:05:58 +0000 (-0800)
Subject: bpo-38657: Clarify numeric padding behaviour in string formatting (GH-17036)
X-Git-Tag: v3.7.7rc1~30
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=09db1da63f866afff8a64ae3c60acdcd6bc80501;p=thirdparty%2FPython%2Fcpython.git

bpo-38657: Clarify numeric padding behaviour in string formatting (GH-17036)


Make the definition of the width more explicit that it includes any
extra signs added by other options.

https://bugs.python.org/issue38657

Automerge-Triggered-By: @Mariatta
(cherry picked from commit 424e5686d82235e08f8108b8bbe034bc91421689)

Co-authored-by: Pete Wicken <2273100+JamoBox@users.noreply.github.com>
---

diff --git a/Doc/library/string.rst b/Doc/library/string.rst
index bbbfed273ee4..6cbe54963196 100644
--- a/Doc/library/string.rst
+++ b/Doc/library/string.rst
@@ -416,8 +416,9 @@ error.
 .. versionchanged:: 3.6
    Added the ``'_'`` option (see also :pep:`515`).
 
-*width* is a decimal integer defining the minimum field width.  If not
-specified, then the field width will be determined by the content.
+*width* is a decimal integer defining the minimum total field width,
+including any prefixes, separators, and other formatting characters.
+If not specified, then the field width will be determined by the content.
 
 When no explicit alignment is given, preceding the *width* field by a zero
 (``'0'``) character enables