documented initialization.