improvements to manual