Documentation on the definitions system.

This should hopefully clarify a few things about why these definitions exist
and how they are generated.