Is there any better documentation for all the smarts tools - than just the --help option?

Yes I have the PDF files - but the sum total of many tools is a 1 line reference to it.

For instance

# sm_tpmgr

It has the ability to show pending agents - but there's no information on what makes them pending / or what attributes I could look at to find out more ..

And there are so many objects that have methods - where can I find out more about them?