Improve docblocks

Couple of docblock and linting fixes.
I don't see why this shouldn't be able to take an integer, provided the architecture supports it.