Fix the enum postincrements, and document (doh)

Not sure what I was thinking...