Don't throw InterruptedException to caller
Javadoc and variable rename

- Add Javadocs to all existing methods
- Rename method arguments to better represent purpose