Slightly improve code comments
Regenerate annotated source docs