Improve docblock and use short array syntax.

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