Add javadoc to help plugin developers figure out what things actually do.

[ChristopherSchultz]

I had to figure out what these methods did while developing my plugins, and it would have been very helpful to have this javadoc to guide me.

NOTE: Zero code changes are includes; this is javadoc only.