ZF-4299: Zend Form documentation - disable escaping on form output seems unclear


After reading through the Zend Form documentation several times I still encountered problems attempting to disable 'Zend_Form_Element_Radio' from escaping html characters within my radio button data. Would it be possible to add a section detailing how to achieve this? I eventually discovered that calling $element->setAttrib('escape', false) achieved this but had to resort to debugging to figure this out.


I can also verify that this is a bit of a tough one to figure out without a debugger or reading through the code. Closest thing I could find in the docs is […], but 'escape' is not mentioned there. I've attached a patch for that section of the documentation (which also details 'listsep'), however it is possibly incomplete as there may be other elements that use 'escape' which I did not list. Patch submitted anyway in an attempt to be as helpful as possible here.

Patch applied on trunk (25114) and release-1.12 (25115)