add docs and comments
fix warns
upd CHANGES && make examples more readable for metacpan
upd dist info