doc cleanup, getting ready for cairo/cl2d as graphics engine.