diff options
author | Luboš Luňák <l.lunak@collabora.com> | 2021-09-17 14:19:47 +0200 |
---|---|---|
committer | Luboš Luňák <l.lunak@collabora.com> | 2021-09-18 19:24:46 +0200 |
commit | 8d8d25f5ddbe42fc5a3647ff0ad31e93311b9ed5 (patch) | |
tree | 73427841594aa8a71b24ddd9e90ae588b5c72df3 /compilerplugins/README.md | |
parent | 328c12a9a011c9a8ac74c89a493b1a75e853a638 (diff) |
make FORCE_COMPILE_ALL more flexible than all or nothing
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 <l.lunak@collabora.com>
Diffstat (limited to 'compilerplugins/README.md')
-rw-r--r-- | compilerplugins/README.md | 11 |
1 files changed, 8 insertions, 3 deletions
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=<rewriter_name>` 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=<scope>` - 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 |