From 09db1da63f866afff8a64ae3c60acdcd6bc80501 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Thu, 20 Feb 2020 22:05:58 -0800 Subject: [PATCH] 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> --- Doc/library/string.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) 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 -- 2.47.3