This fixes the prototypes for the cogl_primitive_new_xyz functions and also adds documentation with examples for each one.