go vet spotted unreachable code...
Added a couple of wee bits of documentation.

It seems like commands only get documentation for
the command, not for its internals. I need to split
into a command and library to muck around with this
further, I suspect.