am bf370185: Doc update: restoring deprecation messages

* commit 'bf3701854841f97f52cd29b601431861598f5277':
  Doc update: restoring deprecation messages