Improves docblock and some internal API.

Signed-off-by: crynobone <crynobone@gmail.com>