Embark on an epic journey to document the dialog engine in as much detail as possible.

... and the previous commits (from 56f73cb on) were by and large a result of things noticed during this process.

osx/dialogxml/button.cpp

@@ -289,12 +289,10 @@ void cLedGroup::recalcRect(){
 	frame.inset(-6,-6);
 }
 
-/** A click handler is called whenever a click is received, even on the currently selected element. */
 void cLedGroup::attachClickHandler(click_callback_t f) throw() {
 	onClick = f;
 }
 
-/** A focus handler is called when the currently selected element changes. */
 void cLedGroup::attachFocusHandler(focus_callback_t f) throw() {
 	onFocus = f;
 }