HADOOP-148: Fixes documentation for Pig and various minor inconsistencies in the code
a few tweaks to modernize docs and pass checkstyle
rolling back parameter order changes
slight code clean ups