clarify deprecation /cc @cvrebert