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.