For short form fields it makes sense to have the #description appear below the form widget; however, in long lists of checkboxes and/or radio buttons it would be nice to be able to have a toggle whether the #description appears above, or below, the form widget.
Although this can be themed with theme_form_element, it is not currently possible to make this change from within the GUI. I see it as being an option similar to setting the size of a text field (default 60 characters, but editable). At present I ask my clients to include their instructions for long form widgets in the "label" (#title) instead of the #description so that the instructions appear at the "right" end of the form.
An example screenshot of the form themed is available here: http://flickr.com/photos/emmajane/2890910395/
I would also like to see this available for CCK "multiple fields" (such as imagefield). This does not use the core function theme_form_element; however, it would be able to take advantage of the new toggle #description above/below setting.
|FAILED: [[SimpleTest]]: [PHP 5.4 MySQL] Unable to apply patch description_display-314385-111.patch. Unable to apply patch. See the log in the details link for more information.|
|FAILED: [[SimpleTest]]: [MySQL] Unable to apply patch description_display-314385-108.patch. Unable to apply patch. See the log in the details link for more information.|
|FAILED: [[SimpleTest]]: [MySQL] 59,754 pass(es), 3 fail(s), and 0 exception(s).|
|FAILED: [[SimpleTest]]: [MySQL] 59,509 pass(es), 3 fail(s), and 0 exception(s).|