Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-08 Thread DaveC
@Greg I felt the need to reply on the topic of what GWT is/does... What (Java) devs think GWT is/does... *** Removes the need for them to understand ANY front end web technologies (e.g. HTML, Javascript, DOM, CSS + xbrowser differences) *** All of our Java developers (where I work) have found

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-07 Thread Greg Dougherty
Jeff, My point is, why isn't that stuff in the JavaDoc? Assigns a Handler for a KeyPressEvent. It is fired, once, whenever a key is pressed down and then released. With, perhaps, a link to the W3C definition of a KeyPress. The person writing that code needs to know that, yes? And probably has

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-07 Thread Greg Dougherty
If I knew JavaScript and DOM, or, for that matter, even WANTED to know JavaScript and DOM, I wouldn't be using GWT, I'd be writing the JavaScript myself. No? No. Abstractions do not work for these kind of things. It's not a matter of abstractions, it's a matter of explanations. IMAO,

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-07 Thread Jeff Schwartz
Hi Greg, I have been in IT for a very long time. You see, I am what the youngins sometimes refer to as an ol' fart :). As a matter of fact, I've been a developer in one form or another for so long that everything else prior to that seems to me to be prehistory - a vague sense of something there

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-07 Thread Greg Dougherty
Hi Jeff, If it ever comes to be the situation that the only way I can do programming is on the web, then I'll waste the time to learn the current iteration of web programming. But life is currently not so dim or dreary, and doesn't look to be that way any time soon. (And if I am going to take

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-07 Thread Jeff Schwartz
Good luck! On Tue, Dec 7, 2010 at 3:08 PM, Greg Dougherty dougherty.greg...@mayo.eduwrote: Hi Jeff, If it ever comes to be the situation that the only way I can do programming is on the web, then I'll waste the time to learn the current iteration of web programming. But life is currently

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-07 Thread A. Stevko
Greg - I admire your position on the quality of documentation. IMO, a measure of a sw engineer is not how much arcana he knows but rather knowing where to find it. Javadocs have long been a great source for the many of the details that I face daily although they typically suck for usability. A

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-07 Thread Jeff Chimene
As one who writes documentation professionally, I see the impedance mismatch between Greg's desires and Javadoc. AFAICT, Greg wants to know why; Javadoc describes how. A toolkit that evolves as rapidly as GWT does not lend itself to in-depth why documentation. I see that the GWT team puts

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-04 Thread Thomas Broyer
On 3 déc, 20:50, Greg Dougherty dougherty.greg...@mayo.edu wrote: Jeff, Thank you.  That' lets me know which one I want to use. If I knew JavaScript and DOM, or, for that matter, even WANTED to know JavaScript and DOM, I wouldn't be using GWT, I'd be writing the JavaScript myself.  No?

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-04 Thread Jeff Schwartz
You are welcome, Greg. In the future, whenever you are unsure about an event type, check the documentation out at W3C's site for a starter as many GWT events map 1 to 1 to DOM javascript events. By reading up on the javascript event it will shed light on the GWT side of things. There are other

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-03 Thread Jeff Schwartz
KeyPress - triggered when the user presses a key and releases it (key down and then key up) KeyDown - triggered when the user presses the key (key down) Perhaps the documentation assumes some prior knowledge of javascript and dom events and though GWT tries to shield the developer from much of it

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-03 Thread Jim Douglas
It can help to remember that GWT generates JavaScript, so GWT concepts (widgets, events, etc) generally map pretty much directly to JavaScript concepts. In this case, you can start with a google search for those events: http://www.google.com/search?q=keydown+keypress+keyup The first item in

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-03 Thread Greg Dougherty
Jeff, Thank you. That' lets me know which one I want to use. If I knew JavaScript and DOM, or, for that matter, even WANTED to know JavaScript and DOM, I wouldn't be using GWT, I'd be writing the JavaScript myself. No? The whole point of using something like GWT is that it lets a Java

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-03 Thread David Chandler
Hi Greg, Prior to joining Google, I thought (and still do think) that the GWT developer guides are actually pretty rich for an open source project and many of the Javadocs, too. Of course, there are always holes and we welcome constructive feedback through the issue tracker. GWT is open source,

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-03 Thread Brian Reilly
Greg, For what it's worth, I had very similar feelings when I ran into a very similar problem. (I was trying to get consistent behavior when pressing enter or tab. Tab is a tricky one because different browsers do different things with different events to handle element focus. Hint: in Safari,

Re: GWT JavaDoc failures KeyPress v. KeyDown

2010-12-03 Thread Greg Dougherty
Hi David, I must humbly disagree. Maybe I just don't see enough Open Source projects, but MySQL, which I use on a regular basis, has documentation that is easy to search, has it all in one place, and does a good job of explaining what's going on. The GWT documentation, OTOH, in my experience