bazelbuild/bazel

Clarify --compilation_mode usage

Open

#10.242 aberto em 15 de nov. de 2019

Ver no GitHub
 (2 comments) (1 reaction) (0 assignees)Java (4.465 forks)batch import
P3help wantedteam-Configurabilityteam-Documentationtype: documentation (cleanup)

Métricas do repositório

Stars
 (25.384 stars)
Métricas de merge de PR
 (Mesclagem média 22d 20h) (77 fundiu PRs em 30d)

Description

Description of the problem / feature request:

compilation_mode is great, but few people know, understand and use it.

For rule developers, it's common to have a rule that produces different outputs based on debugging/optimization settings. So we ended with having attributes like debug, compress etc on the rules, which is annoying and also less optimal to use for various reasons.

Throughout the entire rule design totorial, configuration_mode is not mentioned. Without knowing such a configuration exists, people find their own way to solve an already solved problem.

Also per the user manual:

This option takes an argument of fastbuild, dbg or opt, and affects various C/C++ code-generation options, such as the level of optimization and the completeness of debug tables. Bazel uses a different output directory for each different compilation mode, so you can switch between modes without needing to do a full rebuild every time.

It gives the impression that compilation_mode only works for C/C++ builds, but it's something that affects all rules that support it. Having those misleading statements are not promoting the usage of this feature.

Guia do colaborador