X-Git-Url: https://git.lizzy.rs/?a=blobdiff_plain;f=library%2Fstd%2Fsrc%2Fmacros.rs;h=b2c5df5410dcab9fa484fc654722a5241a1c9315;hb=6d34a2e0074c5ce3e0da4743616ec5b3e96253fb;hp=b729349cf530f411adced32a03f01457b2531c9a;hpb=0b417ab5cdfdedffd74fb22cf22d27033c851304;p=rust.git

diff --git a/library/std/src/macros.rs b/library/std/src/macros.rs
index b729349cf53..b2c5df5410d 100644
--- a/library/std/src/macros.rs
+++ b/library/std/src/macros.rs
@@ -185,9 +185,10 @@ macro_rules! eprintln {
 /// builds or when debugging in release mode is significantly faster.
 ///
 /// Note that the macro is intended as a debugging tool and therefore you
-/// should avoid having uses of it in version control for long periods.
-/// Use cases involving debug output that should be added to version control
-/// are better served by macros such as [`debug!`] from the [`log`] crate.
+/// should avoid having uses of it in version control for long periods
+/// (other than in tests and similar).
+/// Debug output from production code is better done with other facilities
+/// such as the [`debug!`] macro from the [`log`] crate.
 ///
 /// # Stability
 ///