diff --git a/src/libstd/macros.rs b/src/libstd/macros.rs
index a0c3f013f2b4e..a07d21add8db9 100644
--- a/src/libstd/macros.rs
+++ b/src/libstd/macros.rs
@@ -68,6 +68,10 @@ macro_rules! panic {
 /// necessary to use `io::stdout().flush()` to ensure the output is emitted
 /// immediately.
 ///
+/// # Panics
+///
+/// Panics if writing to `io::stdout()` fails.
+///
 /// # Examples
 ///
 /// ```
@@ -99,6 +103,10 @@ macro_rules! print {
 /// Use the `format!` syntax to write data to the standard output.
 /// See `std::fmt` for more information.
 ///
+/// # Panics
+///
+/// Panics if writing to `io::stdout()` fails.
+///
 /// # Examples
 ///
 /// ```