Better documentation of kind attribute

I updated the documentation for the kind attribute. I also made some very minor extra modifications.

There is one thing I think I might have misunderstood: What did you mean with the notes regarding "complfunc", "ftplugin" and "plugin"? In this patch, I have thought you mean that these were earlier accepted as values for the kind attribute.