ADD detailed doc for kriterium/flags

TODO explicit function docs
TODO unit tests
TEST OK per ~/test/everything.go - OK