Fix a bug in reference documentation generation.
Document the scheduling a bit.