doxygen: initial arducopter comment marathon

Added doxygen file and function headers, added lots of comments.

I've listed 15 FIXMEs that perhaps Randy / someone could look at where I wasnt sure on the purpose or the param units.

Best
Gareth