Use a PendingDeprecationWarning, thanks Alex/Florian.
Add notes about comments to the release notes and deprecation timeline.