The documentation so far is rather deficient and full of errors. If it doesn't answer your questions, consult the mailing list or ask us. If you think you can do better, we welcome patches.
The references are often incomplete or wrong, especially in places that have been changing.