]> granicus.if.org Git - python/commitdiff
Backport r73983: Document the thousands separator.
authorAndrew M. Kuchling <amk@amk.ca>
Mon, 5 Oct 2009 22:42:56 +0000 (22:42 +0000)
committerAndrew M. Kuchling <amk@amk.ca>
Mon, 5 Oct 2009 22:42:56 +0000 (22:42 +0000)
Doc/library/string.rst

index 9a13dc6667a1c5065882f32f2a5b15e64c082767..f5a1a3e18f6f0cb493ab8491bde2afff9125194a 100644 (file)
@@ -325,7 +325,7 @@ result as if you had called :func:`str` on the value.
 The general form of a *standard format specifier* is:
 
 .. productionlist:: sf
-   format_spec: [[`fill`]`align`][`sign`][#][0][`width`][.`precision`][`type`]
+   format_spec: [[`fill`]`align`][`sign`][#][0][`width`][,][.`precision`][`type`]
    fill: <a character other than '}'>
    align: "<" | ">" | "=" | "^"
    sign: "+" | "-" | " "
@@ -383,6 +383,10 @@ The ``'#'`` option is only valid for integers, and only for binary, octal, or
 hexadecimal output.  If present, it specifies that the output will be prefixed
 by ``'0b'``, ``'0o'``, or ``'0x'``, respectively.
 
+The ``','`` option signals the use of a comma for a thousands separator.
+For a locale aware separator, use the ``'n'`` integer presentation type
+instead.
+
 *width* is a decimal integer defining the minimum field width.  If not
 specified, then the field width will be determined by the content.