Fix register nym docs

The cost of documentation becomes clear immediately in 9272fad.

Other than that I'm wondering how far I should go explaining the returned message.
"nymIdSource" :-) And what do you mean by optional? There's no such thing in Go, that I know of.