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 
Cool, it appears you are right.