improved documentation for user.id/user_text

As discussed on IRC. This should avoid the confusion I had about the fact that user_text is overloaded so that it is includes both a username if the name is defined and an IP address if it's not. Please edit away to make it more clear, etc. :)