refactor: addapt doc comments and examples to Builder changes

Author: djugei

examples/custom_format.rs

@@ -29,7 +29,7 @@ fn main() {
             .write_style("MY_LOG_STYLE");
 
         Builder::from_env(env)
-            .format(|buf, record| {
+            .build_with_format_fn(|buf, record| {
                 // We are reusing `anstyle` but there are `anstyle-*` crates to adapt it to your
                 // preferred styling crate.
                 let warn_style = buf.default_level_style(log::Level::Warn);
@@ -41,7 +41,8 @@ fn main() {
                     record.args()
                 )
             })
-            .init();
+            .try_init()
+            .unwrap();
     }
 
     init_logger();

examples/syslog_friendly_format.rs

@@ -3,7 +3,7 @@ use std::io::Write;
 fn main() {
     match std::env::var("RUST_LOG_STYLE") {
         Ok(s) if s == "SYSTEMD" => env_logger::builder()
-            .format(|buf, record| {
+            .build_with_format_fn(|buf, record| {
                 writeln!(
                     buf,
                     "<{}>{}: {}",
@@ -18,7 +18,8 @@ fn main() {
                     record.args()
                 )
             })
-            .init(),
+            .try_init()
+            .unwrap(),
         _ => env_logger::init(),
     };
 }

src/fmt/humantime.rs

@@ -15,7 +15,7 @@ impl Formatter {
     ///
     /// let mut builder = env_logger::Builder::new();
     ///
-    /// builder.format(|buf, record| {
+    /// builder.build_with_format_fn(|buf, record| {
     ///     let ts = buf.timestamp();
     ///
     ///     writeln!(buf, "{}: {}: {}", ts, record.level(), record.args())

src/fmt/mod.rs

@@ -7,7 +7,7 @@
 //!
 //! # Formatting log records
 //!
-//! The format used to print log records can be customised using the [`Builder::format`]
+//! The format used to print log records can be customised using the [`Builder::build_with_format_fn`]
 //! method.
 //!
 //! Terminal styling is done through ANSI escape codes and will be adapted to the capabilities of
@@ -25,7 +25,7 @@
 //!
 //! let mut builder = env_logger::Builder::new();
 //!
-//! builder.format(|buf, record| {
+//! builder.build_with_format_fn(|buf, record| {
 //!     writeln!(buf, "{}: {}",
 //!         record.level(),
 //!         record.args())
@@ -124,7 +124,7 @@ impl Default for TimestampPrecision {
 ///
 /// let mut builder = env_logger::Builder::new();
 ///
-/// builder.format(|buf, record| writeln!(buf, "{}: {}", record.level(), record.args()));
+/// builder.build_with_format_fn(|buf, record| writeln!(buf, "{}: {}", record.level(), record.args()));
 /// ```
 ///
 /// [`Write`]: std::io::Write

src/lib.rs

@@ -253,10 +253,10 @@
 //! use std::io::Write;
 //!
 //! env_logger::builder()
-//!     .format(|buf, record| {
+//!     .build_with_format_fn(|buf, record| {
 //!         writeln!(buf, "{}: {}", record.level(), record.args())
 //!     })
-//!     .init();
+//!     .try_init().unwrap();
 //! ```
 //!
 //! See the [`fmt`] module for more details about custom formats.

src/logger.rs

@@ -27,9 +27,9 @@ pub const DEFAULT_WRITE_STYLE_ENV: &str = "RUST_LOG_STYLE";
 /// let mut builder = Builder::from_default_env();
 ///
 /// builder
-///     .format(|buf, record| writeln!(buf, "{} - {}", record.level(), record.args()))
 ///     .filter(None, LevelFilter::Info)
-///     .init();
+///     .build_with_format_fn(|buf, record| writeln!(buf, "{} - {}", record.level(), record.args()))
+///     .try_init().unwrap();
 ///
 /// error!("error message");
 /// info!("info message");