a few warnings, javadoc, and one missing scheduler parameter

This is just a quick fix for #368 according to @samuelgruetter's comments.

I also removed a few unnecessary `@SuppressWarnings("unchecked")` and one unnecessary semicolon.