[Python-checkins] cpython (2.7): Issue #15660: Further clarify 0 prefix for width specifier in formats.

[terry.reedy]

https://hg.python.org/cpython/rev/de669512df97
changeset:   100629:de669512df97
branch:      2.7
user:        Terry Jan Reedy <tjreedy at udel.edu>
date:        Sun Mar 20 21:05:50 2016 -0400
summary:
  Issue #15660: Further clarify 0 prefix for width specifier in formats.

files:
  Doc/library/string.rst |  6 ++++--
  1 files changed, 4 insertions(+), 2 deletions(-)


diff --git a/Doc/library/string.rst b/Doc/library/string.rst
--- a/Doc/library/string.rst
+++ b/Doc/library/string.rst
@@ -353,7 +353,8 @@
    | ``'='`` | Forces the padding to be placed after the sign (if any)  |
    |         | but before the digits.  This is used for printing fields |
    |         | in the form '+000000120'. This alignment option is only  |
-   |         | valid for numeric types.                                 |
+   |         | valid for numeric types.  It becomes the default when '0'|
+   |         | immediately precedes the field width.                    |
    +---------+----------------------------------------------------------+
    | ``'^'`` | Forces the field to be centered within the available     |
    |         | space.                                                   |
@@ -393,7 +394,8 @@
 *width* is a decimal integer defining the minimum field width.  If not
 specified, then the field width will be determined by the content.
 
-Preceding the *width* field by a zero (``'0'``) character enables
+When no explicit alignment is given, preceding the *width* field by a zero
+(``'0'``) character enables
 sign-aware zero-padding for numeric types.  This is equivalent to a *fill*
 character of ``'0'`` with an *alignment* type of ``'='``.
 

-- 
Repository URL: https://hg.python.org/cpython