commenting exported types/functions. small optimizations per golint.