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.
"Optional" from the point of view of the C++ API. Meaning that the arguments are ignored if they are the empty string. I agree that this should be clearer.