add deprecation warning to docs
Merge branch 'master' into v1.4