correct API documentation for header/footer spacing (fixes #1708)