about summary refs log tree commit diff
diff options
context:
space:
mode:
authorJim Blandy <jimb@red-bean.com>2017-02-22 21:18:52 -0800
committerJim Blandy <jimb@red-bean.com>2017-02-22 21:18:52 -0800
commit6b8e1756c7f3bf4d94973ef0702e252277d10763 (patch)
tree9d187fb2260ddc72e5f12e70f2a5395080b0f3b4
parentbfe45974a18af63191d40a6ac5beb0cf2ab9c9f7 (diff)
downloadrust-6b8e1756c7f3bf4d94973ef0702e252277d10763.tar.gz
rust-6b8e1756c7f3bf4d94973ef0702e252277d10763.zip
Update std::fmt module docs for landing of #33642.
-rw-r--r--src/libcollections/fmt.rs25
1 files changed, 4 insertions, 21 deletions
diff --git a/src/libcollections/fmt.rs b/src/libcollections/fmt.rs
index bd74848a01d..079541235a2 100644
--- a/src/libcollections/fmt.rs
+++ b/src/libcollections/fmt.rs
@@ -62,7 +62,7 @@
 //!
 //! A format string is required to use all of its arguments, otherwise it is a
 //! compile-time error. You may refer to the same argument more than once in the
-//! format string, although it must always be referred to with the same type.
+//! format string.
 //!
 //! ## Named parameters
 //!
@@ -89,19 +89,8 @@
 //!
 //! ## Argument types
 //!
-//! Each argument's type is dictated by the format string. It is a requirement
-//! that every argument is only ever referred to by one type. For example, this
-//! is an invalid format string:
-//!
-//! ```text
-//! {0:x} {0:o}
-//! ```
-//!
-//! This is invalid because the first argument is both referred to as a
-//! hexadecimal as well as an
-//! octal.
-//!
-//! There are various parameters which do require a particular type, however.
+//! Each argument's type is dictated by the format string.
+//! There are various parameters which require a particular type, however.
 //! An example is the `{:.*}` syntax, which sets the number of decimal places
 //! in floating-point types:
 //!
@@ -113,13 +102,7 @@
 //!
 //! If this syntax is used, then the number of characters to print precedes the
 //! actual object being formatted, and the number of characters must have the
-//! type `usize`. Although a `usize` can be printed with `{}`, it is invalid to
-//! reference an argument as such. For example this is another invalid format
-//! string:
-//!
-//! ```text
-//! {:.*} {0}
-//! ```
+//! type `usize`.
 //!
 //! ## Formatting traits
 //!