buf_redux 0.8.4

Drop-in replacements for buffered I/O in `std::io` with extra features.
Documentation
Build #1748612 2025-02-13T20:08:53.727858+00:00
# rustc version
rustc 1.86.0-nightly (ef148cd7e 2025-02-12)# docs.rs version
docsrs 0.6.0 (35977596 2025-02-09)# build log
[INFO] running `Command { std: "docker" "create" "-v" "/home/cratesfyi/workspace/builds/buf_redux-0.8.4/target:/opt/rustwide/target:rw,Z" "-v" "/home/cratesfyi/workspace/builds/buf_redux-0.8.4/source:/opt/rustwide/workdir:ro,Z" "-v" "/home/cratesfyi/workspace/cargo-home:/opt/rustwide/cargo-home:ro,Z" "-v" "/home/cratesfyi/workspace/rustup-home:/opt/rustwide/rustup-home:ro,Z" "-e" "SOURCE_DIR=/opt/rustwide/workdir" "-e" "CARGO_TARGET_DIR=/opt/rustwide/target" "-e" "DOCS_RS=1" "-e" "CARGO_HOME=/opt/rustwide/cargo-home" "-e" "RUSTUP_HOME=/opt/rustwide/rustup-home" "-w" "/opt/rustwide/workdir" "-m" "6442450944" "--cpus" "6" "--user" "1001:1001" "--network" "none" "ghcr.io/rust-lang/crates-build-env/linux@sha256:3959728d45483eb673ba100a951a6b9f5012970368db2a9e08e0ac9b67c8a5ad" "/opt/rustwide/cargo-home/bin/cargo" "+nightly" "rustdoc" "--lib" "-Zrustdoc-map" "--config" "build.rustdocflags=[\"--cfg\", \"docsrs\", \"-Z\", \"unstable-options\", \"--emit=invocation-specific\", \"--resource-suffix\", \"-20250212-1.86.0-nightly-ef148cd7e\", \"--static-root-path\", \"/-/rustdoc.static/\", \"--cap-lints\", \"warn\", \"--extern-html-root-takes-precedence\"]" "--offline" "-Zunstable-options" "--config=doc.extern-map.registries.crates-io=\"https://docs.rs/{pkg_name}/{version}/x86_64-unknown-linux-gnu\"" "-Zrustdoc-scrape-examples" "-j6" "--target" "x86_64-unknown-linux-gnu", kill_on_drop: false }`
[INFO] [stderr] WARNING: Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap.
[INFO] [stdout] 1ed8e1070e82de321a058b9ccdd67b9f3687776793fcd981ec16a4d1ab9293ad
[INFO] running `Command { std: "docker" "start" "-a" "1ed8e1070e82de321a058b9ccdd67b9f3687776793fcd981ec16a4d1ab9293ad", kill_on_drop: false }`
[INFO] [stderr] warning: no edition set: defaulting to the 2015 edition while the latest is 2024
[INFO] [stderr] warning: target filter specified, but no targets matched; this is a no-op
[INFO] [stderr]  Documenting buf_redux v0.8.4 (/opt/rustwide/workdir)
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]   --> src/lib.rs:74:39
[INFO] [stderr]    |
[INFO] [stderr] 74 | //! as their buffer types ([`Buffer`](Buffer) is included as well since it is used internally
[INFO] [stderr]    |                             --------  ^^^^^^ explicit target is redundant
[INFO] [stderr]    |                             |
[INFO] [stderr]    |                             because label contains path that resolves to same destination
[INFO] [stderr]    |
[INFO] [stderr]    = note: when a link's destination is not specified,
[INFO] [stderr]            the label is used to resolve intra-doc links
[INFO] [stderr]    = note: `#[warn(rustdoc::redundant_explicit_links)]` on by default
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]    |
[INFO] [stderr] 74 - //! as their buffer types ([`Buffer`](Buffer) is included as well since it is used internally
[INFO] [stderr] 74 + //! as their buffer types ([`Buffer`] is included as well since it is used internally
[INFO] [stderr]    |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:106:79
[INFO] [stderr]     |
[INFO] [stderr] 106 | //! as the `.make_room()` methods, and is utilized by [`policy::MinBuffered`](policy::MinBuffered)
[INFO] [stderr]     |                                                        ---------------------  ^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                                                        |
[INFO] [stderr]     |                                                        because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 106 - //! as the `.make_room()` methods, and is utilized by [`policy::MinBuffered`](policy::MinBuffered)
[INFO] [stderr] 106 + //! as the `.make_room()` methods, and is utilized by [`policy::MinBuffered`]
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:107:32
[INFO] [stderr]     |
[INFO] [stderr] 107 | //! and [`policy::FlushExact`](policy::FlushExact).
[INFO] [stderr]     |          --------------------  ^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |          |
[INFO] [stderr]     |          because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 107 - //! and [`policy::FlushExact`](policy::FlushExact).
[INFO] [stderr] 107 + //! and [`policy::FlushExact`].
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:210:59
[INFO] [stderr]     |
[INFO] [stderr] 210 |     /// default capacity and the default [`ReaderPolicy`](policy::ReaderPolicy).
[INFO] [stderr]     |                                           --------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                                           |
[INFO] [stderr]     |                                           because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 210 -     /// default capacity and the default [`ReaderPolicy`](policy::ReaderPolicy).
[INFO] [stderr] 210 +     /// default capacity and the default [`ReaderPolicy`].
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:216:68
[INFO] [stderr]     |
[INFO] [stderr] 216 |     /// of *at least* `cap` bytes and the default [`ReaderPolicy`](policy::ReaderPolicy).
[INFO] [stderr]     |                                                    --------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                                                    |
[INFO] [stderr]     |                                                    because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 216 -     /// of *at least* `cap` bytes and the default [`ReaderPolicy`](policy::ReaderPolicy).
[INFO] [stderr] 216 +     /// of *at least* `cap` bytes and the default [`ReaderPolicy`].
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:280:45
[INFO] [stderr]     |
[INFO] [stderr] 280 |     /// Mutate the current [`ReaderPolicy`](policy::ReaderPolicy) in-place.
[INFO] [stderr]     |                             --------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                             |
[INFO] [stderr]     |                             because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 280 -     /// Mutate the current [`ReaderPolicy`](policy::ReaderPolicy) in-place.
[INFO] [stderr] 280 +     /// Mutate the current [`ReaderPolicy`] in-place.
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:506:26
[INFO] [stderr]     |
[INFO] [stderr] 506 |     /// [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr]     |          --------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |          |
[INFO] [stderr]     |          because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 506 -     /// [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr] 506 +     /// [`WriterPolicy`].
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:512:68
[INFO] [stderr]     |
[INFO] [stderr] 512 |     /// of *at least* `cap` bytes and the default [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr]     |                                                    --------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                                                    |
[INFO] [stderr]     |                                                    because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 512 -     /// of *at least* `cap` bytes and the default [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr] 512 +     /// of *at least* `cap` bytes and the default [`WriterPolicy`].
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:521:39
[INFO] [stderr]     |
[INFO] [stderr] 521 |     /// capacity and [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr]     |                       --------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                       |
[INFO] [stderr]     |                       because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 521 -     /// capacity and [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr] 521 +     /// capacity and [`WriterPolicy`].
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:538:51
[INFO] [stderr]     |
[INFO] [stderr] 538 |     /// capacity and the default [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr]     |                                   --------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                                   |
[INFO] [stderr]     |                                   because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 538 -     /// capacity and the default [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr] 538 +     /// capacity and the default [`WriterPolicy`].
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:554:86
[INFO] [stderr]     |
[INFO] [stderr] 554 |     /// Create a new `BufWriter` wrapping `inner`, utilizing the existing [`Buffer`](Buffer)
[INFO] [stderr]     |                                                                            --------  ^^^^^^ explicit target is redundant
[INFO] [stderr]     |                                                                            |
[INFO] [stderr]     |                                                                            because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 554 -     /// Create a new `BufWriter` wrapping `inner`, utilizing the existing [`Buffer`](Buffer)
[INFO] [stderr] 554 +     /// Create a new `BufWriter` wrapping `inner`, utilizing the existing [`Buffer`]
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:555:51
[INFO] [stderr]     |
[INFO] [stderr] 555 |     /// instance and the default [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr]     |                                   --------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                                   |
[INFO] [stderr]     |                                   because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 555 -     /// instance and the default [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr] 555 +     /// instance and the default [`WriterPolicy`].
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:568:36
[INFO] [stderr]     |
[INFO] [stderr] 568 |     /// Set a new [`WriterPolicy`](policy::WriterPolicy), returning the transformed type.
[INFO] [stderr]     |                    --------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                    |
[INFO] [stderr]     |                    because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 568 -     /// Set a new [`WriterPolicy`](policy::WriterPolicy), returning the transformed type.
[INFO] [stderr] 568 +     /// Set a new [`WriterPolicy`], returning the transformed type.
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:578:45
[INFO] [stderr]     |
[INFO] [stderr] 578 |     /// Mutate the current [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr]     |                             --------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                             |
[INFO] [stderr]     |                             because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 578 -     /// Mutate the current [`WriterPolicy`](policy::WriterPolicy).
[INFO] [stderr] 578 +     /// Mutate the current [`WriterPolicy`].
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:739:19
[INFO] [stderr]     |
[INFO] [stderr] 739 | /// [`BufWriter`](BufWriter)`<W, `[`policy::FlushOnNewline`](policy::FlushOnNewline)`>`, which
[INFO] [stderr]     |      -----------  ^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |      |
[INFO] [stderr]     |      because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 739 - /// [`BufWriter`](BufWriter)`<W, `[`policy::FlushOnNewline`](policy::FlushOnNewline)`>`, which
[INFO] [stderr] 739 + /// [`BufWriter`]`<W, `[`policy::FlushOnNewline`](policy::FlushOnNewline)`>`, which
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:739:62
[INFO] [stderr]     |
[INFO] [stderr] 739 | /// [`BufWriter`](BufWriter)`<W, `[`policy::FlushOnNewline`](policy::FlushOnNewline)`>`, which
[INFO] [stderr]     |                                    ------------------------  ^^^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                                    |
[INFO] [stderr]     |                                    because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 739 - /// [`BufWriter`](BufWriter)`<W, `[`policy::FlushOnNewline`](policy::FlushOnNewline)`>`, which
[INFO] [stderr] 739 + /// [`BufWriter`](BufWriter)`<W, `[`policy::FlushOnNewline`]`>`, which
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:740:55
[INFO] [stderr]     |
[INFO] [stderr] 740 | /// demonstrates the power of custom [`WriterPolicy`](policy::WriterPolicy) implementations.
[INFO] [stderr]     |                                       --------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |                                       |
[INFO] [stderr]     |                                       because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 740 - /// demonstrates the power of custom [`WriterPolicy`](policy::WriterPolicy) implementations.
[INFO] [stderr] 740 + /// demonstrates the power of custom [`WriterPolicy`] implementations.
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: redundant explicit link target
[INFO] [stderr]    --> src/lib.rs:721:37
[INFO] [stderr]     |
[INFO] [stderr] 721 | /// set by [`set_drop_err_handler`](set_drop_err_handler) for this thread.
[INFO] [stderr]     |             ----------------------  ^^^^^^^^^^^^^^^^^^^^ explicit target is redundant
[INFO] [stderr]     |             |
[INFO] [stderr]     |             because label contains path that resolves to same destination
[INFO] [stderr]     |
[INFO] [stderr]     = note: when a link's destination is not specified,
[INFO] [stderr]             the label is used to resolve intra-doc links
[INFO] [stderr] help: remove explicit link target
[INFO] [stderr]     |
[INFO] [stderr] 721 - /// set by [`set_drop_err_handler`](set_drop_err_handler) for this thread.
[INFO] [stderr] 721 + /// set by [`set_drop_err_handler`] for this thread.
[INFO] [stderr]     |
[INFO] [stderr] 
[INFO] [stderr] warning: `buf_redux` (lib doc) generated 18 warnings
[INFO] [stderr]     Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.34s
[INFO] [stderr]    Generated /opt/rustwide/target/x86_64-unknown-linux-gnu/doc/buf_redux/index.html
[INFO] running `Command { std: "docker" "inspect" "1ed8e1070e82de321a058b9ccdd67b9f3687776793fcd981ec16a4d1ab9293ad", kill_on_drop: false }`
[INFO] running `Command { std: "docker" "rm" "-f" "1ed8e1070e82de321a058b9ccdd67b9f3687776793fcd981ec16a4d1ab9293ad", kill_on_drop: false }`
[INFO] [stdout] 1ed8e1070e82de321a058b9ccdd67b9f3687776793fcd981ec16a4d1ab9293ad