fix travis and add some more substance to docblocks