documented revert workaround