oil docs: filled in much of the important bits of the oil c code