Add API method to retrieve buddy attributes. fixes #223
Add API section to docs and regenerate.