Fixes #1122, documentation details an issue will be fixed before 2.0