print macros: add xrefs to format syntax documentation

This commit is contained in:
Ian Jackson 2022-04-28 14:33:30 +01:00 committed by Ralf Jung
parent 11167071db
commit 55159e80ad

View File

@ -41,6 +41,9 @@ macro_rules! panic {
/// Use `print!` only for the primary output of your program. Use /// Use `print!` only for the primary output of your program. Use
/// [`eprint!`] instead to print error and progress messages. /// [`eprint!`] instead to print error and progress messages.
/// ///
/// See [the formatting documentation in `std::fmt`](../std/fmt/index.html)
/// for details of the macro argument syntax.
///
/// [flush]: crate::io::Write::flush /// [flush]: crate::io::Write::flush
/// [`println!`]: crate::println /// [`println!`]: crate::println
/// [`eprint!`]: crate::eprint /// [`eprint!`]: crate::eprint
@ -103,6 +106,9 @@ macro_rules! print {
/// Use `println!` only for the primary output of your program. Use /// Use `println!` only for the primary output of your program. Use
/// [`eprintln!`] instead to print error and progress messages. /// [`eprintln!`] instead to print error and progress messages.
/// ///
/// See [the formatting documentation in `std::fmt`](../std/fmt/index.html)
/// for details of the macro argument syntax.
///
/// [`std::fmt`]: crate::fmt /// [`std::fmt`]: crate::fmt
/// [`eprintln!`]: crate::eprintln /// [`eprintln!`]: crate::eprintln
/// [lock]: crate::io::Stdout /// [lock]: crate::io::Stdout
@ -150,6 +156,9 @@ macro_rules! println {
/// [`io::stderr`]: crate::io::stderr /// [`io::stderr`]: crate::io::stderr
/// [`io::stdout`]: crate::io::stdout /// [`io::stdout`]: crate::io::stdout
/// ///
/// See [the formatting documentation in `std::fmt`](../std/fmt/index.html)
/// for details of the macro argument syntax.
///
/// # Panics /// # Panics
/// ///
/// Panics if writing to `io::stderr` fails. /// Panics if writing to `io::stderr` fails.
@ -181,6 +190,9 @@ macro_rules! eprint {
/// Use `eprintln!` only for error and progress messages. Use `println!` /// Use `eprintln!` only for error and progress messages. Use `println!`
/// instead for the primary output of your program. /// instead for the primary output of your program.
/// ///
/// See [the formatting documentation in `std::fmt`](../std/fmt/index.html)
/// for details of the macro argument syntax.
///
/// [`io::stderr`]: crate::io::stderr /// [`io::stderr`]: crate::io::stderr
/// [`io::stdout`]: crate::io::stdout /// [`io::stdout`]: crate::io::stdout
/// [`println!`]: crate::println /// [`println!`]: crate::println