updated documentation to explain new settings attributes