add cpychecker inspired fixes; document how to do the same
Merge pull request #210 from ged-lab/python-c-cleanup

add cpychecker inspired fixes; document how to do the same