doc: Runnable examples for log

It took far too long for me to realize how to get the logging macros to print. Also document with `//!` instead of `/*!`.

cc @steveklabnik