add kpopulate and expand README to include examples and exit status descriptions