more documentation
documentation polish
fix utf8 build error
deprecate announce_entry::will_announce
fix initialization order warnings
color output from gen_reference_doc.py