Page on wiki about wiring

Hello,

Is there or could there be a page on the wiki describing how the wiring language is built up from basic avr-libc instructions, and what hardware resources the wiring language claims for itself?

I'm thinking that for the project I'm working on I'll need to go a bit beyond the wiring language, but it would be nice to be able to keep this framework while I get used to things, rather than being plunged into straight C, having to initialise everything myself.

So it would be good if there was a page bringing together information like:

  • what hardware timers wiring uses for itself.
  • how to increase the analogue sample rate.
  • how to start an analogue read and then do other things while the ADC is running.
  • how to use the built in comparators (if this is possible with the arduino board)

and so on. I found this page:
http://www.arduino.cc/playground/Main/AVR
but it's a bit sketchy and doesn't say much about how wiring works, just a few snippets for how to get round its limitations,

Look at "wiring.c"; it doesn't do much at all.
Unfortunately, what it DOES do is pretty variable. How many timers are used depends on whether you use "analogWrite()", and on which pins. If you don't use the wiring Serial functions, it won't load the serial library, and won't touch the serial port. Wiring is more like a set of not-too-well-coordinated library functions than a real operating system.

On the plus side, this means it's pretty easy to override the stuff that wiring does (or might do) with your own functions. For instance, I think most of the servo libraries end up interfering with analogWrite...