[Development] Is this an "example", or a "test" ?

[Rick Stockton]

Hi, everyone.

BACKGROUND:
I think that it might be helpful to add my interactive 
"Qt5_MouseButtonTester" into one of these Trees. It is a manual test 
because it verifies that physical ButtonPress() events work their way up 
through the entire tree (from the OS, through a Qt platform plugin, and 
into the event dispatcher.) Simulating the event, from inside Qt, would 
not test the platform interface. It currently runs by popping up a 
TextArea Widget, and issuing qDebug() messages when MousePress(), 
MouseDoubleClick(), and MouseRelease() events are seen. (It's appearance 
and function are almost identical to "xev |grep utton", run from the 
console in an X11 environment.)

DevNet, and the current source code libraries, do not contain an example 
for users to cut/paste snippets of this process (i.e., overloading the 
Mouse Events.) The forum contains several queries on this matter, so I 
think that it would be helpful to provide such code.

QUESTION 1, Primarily for 'qt-interest' people: Which location would 
expect to find such an example? The manual tests (within core), the 
official Qt examples, or a Wiki article on DevNet?

QUESTION 2:
It currently runs by popping up a TextArea Widget, and issuing qDebug() 
messages when MousePress(), MouseDoubleClick(), and MouseRelease() 
events are seen. If put into Qt as an "example", I think that we would 
want to print the notification text inside the textarea itself (rather 
than the Console). Agreed?

QUESTION 3:
Is the wideget-based example sufficient, or do I REALLY need to write 
another?