rust-lang / log

Logging implementation for Rust
https://docs.rs/log
Apache License 2.0
2.2k stars 254 forks source link

Add "For Implementers" In Documentation For `Log::flush()` #522

Closed AldaronLau closed 7 months ago

AldaronLau commented 2 years ago

There is almost no information / clarity on what flush() should do and if it's called by any of the macros in this crate. I think it should say something like:

This method isn’t called automatically by the log! macros. It can be called manually at shutdown.

KodrAus commented 2 years ago

Thanks for the suggestion @AldaronLau! This sounds like a nice clarification to me.