Add documentation about flushing and flags.
Fix typo, reformat top comment slightly.
document -log_dir, the one undocumented flag in this package.