From 7c60405dd63a2d5720251c97ec209d8844f56395 Mon Sep 17 00:00:00 2001
From: Dylan Nugent <dylnuge@gmail.com>
Date: Mon, 9 Mar 2020 12:31:33 -0400
Subject: [PATCH] Add note about localization to std::fmt docs

---
 src/liballoc/fmt.rs | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/src/liballoc/fmt.rs b/src/liballoc/fmt.rs
index e6162e0f571e2..13ef2f063f95f 100644
--- a/src/liballoc/fmt.rs
+++ b/src/liballoc/fmt.rs
@@ -247,6 +247,21 @@
 //! Hello, `     123` has 3 right-aligned characters
 //! ```
 //!
+//! ## Localization
+//!
+//! In some programming languages, the behavior of string formatting functions
+//! depends on the operating system's locale setting. The format functions
+//! provided by Rust's standard library do not have any concept of locale, and
+//! will produce the same results on all systems regardless of user
+//! configuration.
+//!
+//! For example, the following code will always print `1.5` even if the system
+//! locale uses a decimal separator other than a dot.
+//!
+//! ```
+//! println!("The value is {}", 1.5);
+//! ```
+//!
 //! # Escaping
 //!
 //! The literal characters `{` and `}` may be included in a string by preceding