From 4235681f3f16497e18e0af283b801ed5e52660d6 Mon Sep 17 00:00:00 2001
From: tuturuu <zedddiezxc@gmail.com>
Date: Tue, 29 Oct 2024 20:51:26 +0100
Subject: [PATCH] Rustdoc: added brief colon explanation
---
library/alloc/src/fmt.rs | 15 ++++++++++++---
1 file changed, 12 insertions(+), 3 deletions(-)
diff --git a/library/alloc/src/fmt.rs b/library/alloc/src/fmt.rs
index 3da71038a5e76..109698cb392de 100644
--- a/library/alloc/src/fmt.rs
+++ b/library/alloc/src/fmt.rs
@@ -109,6 +109,15 @@
//! parameters (corresponding to `format_spec` in [the syntax](#syntax)). These
//! parameters affect the string representation of what's being formatted.
//!
+//! The colon `:` in format syntax divides identifier of the input data
+//! and the formatting options, the colon by itself does not change anything, only introduces the
+//! options.
+//! ```
+//! let a = 5;
+//! let b = &a;
+//! println!("{a:e} {b:p}");
+//! ```
+//!
//! ## Width
//!
//! ```
@@ -580,8 +589,10 @@
pub use core::fmt::Alignment;
#[stable(feature = "rust1", since = "1.0.0")]
pub use core::fmt::Error;
+#[unstable(feature = "debug_closure_helpers", issue = "117729")]
+pub use core::fmt::{from_fn, FromFn};
#[stable(feature = "rust1", since = "1.0.0")]
-pub use core::fmt::{Arguments, write};
+pub use core::fmt::{write, Arguments};
#[stable(feature = "rust1", since = "1.0.0")]
pub use core::fmt::{Binary, Octal};
#[stable(feature = "rust1", since = "1.0.0")]
@@ -590,8 +601,6 @@ pub use core::fmt::{Debug, Display};
pub use core::fmt::{DebugList, DebugMap, DebugSet, DebugStruct, DebugTuple};
#[stable(feature = "rust1", since = "1.0.0")]
pub use core::fmt::{Formatter, Result, Write};
-#[unstable(feature = "debug_closure_helpers", issue = "117729")]
-pub use core::fmt::{FromFn, from_fn};
#[stable(feature = "rust1", since = "1.0.0")]
pub use core::fmt::{LowerExp, UpperExp};
#[stable(feature = "rust1", since = "1.0.0")]