clean up more docs
convert TagFlags to an EnumSet-alike
tweak doc phrasing