Better scripting manual!

I've finally started to teach myself to write scripts, and I'm finding the LSL documentation to be severely lacking. It's written with the assumption that the reader already knows programming. For example, saying that a function returns omega is great... provided you know what the hell omega is! With the current documentation someone with no previous programming experience has little chance of learning how to script anything meaningful.

I'm trying to set up a listen for detecting specific owner commands... probably one of the most common script features, and even that isn't explained well enough that I can use it without pouring over the script library trying to decipher other people's scripts to see how it actually works.

Definitions for functions don't explain what any of the arguments actually mean... it assumes you already know.

Please please please write a better LSL manual. I realize that writing a programming manual for beginners is a big job, but LSL is such an important selling point of SL that there ought to be a full time person on staff doing just that.