adding lots of doc block content, plus a little bit of code cleanup
Merge branch 'mhrivnak-newimporter' of github.com:pulp/pulp_rpm into mhrivnak-newimporter