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 
In some shells this can be written `RUST_LOG=main=error ./main`, but I don't know if it is universal.

Also, you can set a global default: `RUST_LOG=error ./main`.