From 8d8d25f5ddbe42fc5a3647ff0ad31e93311b9ed5 Mon Sep 17 00:00:00 2001 From: Luboš Luňák Date: Fri, 17 Sep 2021 14:19:47 +0200 Subject: make FORCE_COMPILE_ALL more flexible than all or nothing MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Rename it to FORCE_COMPILE and it takes the --enable-symbols specification of what to include, for example FORCE_COMPILE="all -sw/ -Library_sc". Change-Id: I92afd8e0abc75d3566285c197d6640c26c03db36 Reviewed-on: https://gerrit.libreoffice.org/c/core/+/122248 Tested-by: Jenkins Reviewed-by: Luboš Luňák --- compilerplugins/README.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) (limited to 'compilerplugins/README.md') diff --git a/compilerplugins/README.md b/compilerplugins/README.md index 9dbea95a56c7..8f8a51bd6f02 100644 --- a/compilerplugins/README.md +++ b/compilerplugins/README.md @@ -34,8 +34,13 @@ Rewriters analyse and possibly modify given source files. Usage: `make COMPILER_PLUGIN_TOOL=` Additional optional make arguments: -- it is possible to also pass `FORCE_COMPILE_ALL=1` to make to trigger rebuild of all source files, - even those that are up to date. +- it is possible to also pass `FORCE_COMPILE=all` to make to trigger rebuild of all source files, + even those that are up to date. FORCE_COMPILE takes a list of gbuild targets specifying + where to run the rewriter ('all' means everything, '-' prepended means to not enable, '/' appended means + everything in the directory; there is no ordering, more specific overrides + more general, and disabling takes precedence). + Example: FORCE_COMPILE="all -sw/ -Library_sc" + - `UPDATE_FILES=` - limits which modified files will be actually written back with the changes - `mainfile` - only the main `.cxx` file will be modified (default) - `all` - all source files involved will be modified (possibly even header files from other LO modules), @@ -54,7 +59,7 @@ all non-rewriter plugins; and all non--dual-mode plugins are disabled). The typical process to use such a dual-mode rewriter X in rewriting mode is make COMPILER_PLUGIN_WARNINGS_ONLY=X \ - && make COMPILER_PLUGIN_TOOL=X FORCE_COMPILE_ALL=1 UPDATE_FILES=all + && make COMPILER_PLUGIN_TOOL=X FORCE_COMPILE=all UPDATE_FILES=all which first generates a full build without failing due to warnings from plugin X in non-rewriting mode (in case of `--enable-werror`) and then repeats the build -- cgit