a few tweaks, comments, ready to go.

git-svn-id: https://plugins.svn.wordpress.org/shortpack/trunk@774584 b8457f37-d9ea-0310-8a92-e5e31aec5664