Please add source code comments explaining why the code does what it does.

[Sporking]

Please add comments in the plugin source code explaining WHAT each function or block of code is intending to accomplish and WHY doing that is necessary or useful (i.e. what would happen if the plugin didn't do that).

It is difficult to determine whether the plugin's behavior is correct or complete without knowing what the goals of the code are intended to be.