From cab3f811983824015f34af968a9dcfe93891f32c Mon Sep 17 00:00:00 2001 From: Lou Berger Date: Thu, 29 Mar 2018 18:50:30 -0400 Subject: [PATCH] doc: add note on use of scripts to enable immediate removale deprecated APIs/macros Signed-off-by: Lou Berger --- doc/developer/workflow.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/developer/workflow.rst b/doc/developer/workflow.rst index 0114a6ddbd..80029cbd1c 100644 --- a/doc/developer/workflow.rst +++ b/doc/developer/workflow.rst @@ -702,6 +702,13 @@ compiler/preprocessor annotations to print warnings at compile time, pointing to the appropriate update path. A ``-Werror`` build should fail if compatibility bits are used. +Preferably, the shell script :file:`tools/fixup-deprecated.py` will be +updated along with making non-backwards compatible code changes, or an +alternate script should be introduced, to update the code to match the +change. When the script is updated, there is no need to preserve the +deprecated code. Note that this does not apply to user interface +changes, just internal code, macros and libraries. + Miscellaneous ------------- -- 2.39.5