I am struggling with the documentation for Zend_Form_Element. First, I was trying to set up a radio group and finally had to go out to the internet to learn that one uses setMultiOptions to do it. This method isn't even mentioned in section 15.4.8.

In addition to this, it would seem that Zend_Form_Element should output without decorators (dd/dl) as a default and then users could be told how to add them. Currently, the documentation concentrates on how to remove the things that Zend adds. Plus, the outputs of this class should be clearly listed; it seems that much has be discovered by reviewing the html afterwards.

Finally, the documentation for this class seems to be more "tutorial" at the expense of being complete. Providing an incomplete listing of method names without explanation is hardly adequate and the class browser doesn't provide much more information.

I understand that this is new to 1.5 but, I want to be a ZF advocate and it is getting difficult.

Can anyone point me to more complete documentation or use cases for the Zend_Form_Element class?