userhost-in-names: improve description, add to index

Not sure if it should be optional or required.
Merge pull request #22 from grawity/userhost-in-names

userhost-in-names: improve description, add to index