DOC: fixes #1731