Clarify why there can be more worker instances for a given mnemonic than specified by `--worker_max_{,multiplex_}instances`.
@@ -75,9 +75,12 @@ public class WorkerOptions extends OptionsBase {
documentationCategory = OptionDocumentationCategory.EXECUTION_STRATEGY,
effectTags = {OptionEffectTag.EXECUTION, OptionEffectTag.HOST_MACHINE_RESOURCE_OPTIMIZATIONS},
help =
- "How many instances of a worker process (like the persistent Java compiler) may be "
+ "How many instances of each kind of persistent worker may be "
+ "launched if you use the 'worker' strategy. May be specified as [name=value] to "
- + "give a different value per worker mnemonic. Takes "
+ + "give a different value per mnemonic. The limit is based on worker keys, which are "
+ + "differentiated based on mnemonic, but also on startup flags and environment, so "
+ + "there can in some cases be more workers per mnemonic than this flag specifies. "
+ + "Takes "
+ ResourceConverter.FLAG_SYNTAX
+ ". 'auto' calculates a reasonable default based on machine capacity. "
+ "\"=value\" sets a default for unspecified mnemonics.",
@@ -95,7 +98,10 @@ public class WorkerOptions extends OptionsBase {
help =
"How many WorkRequests a multiplex worker process may receive in parallel if you use the"
+ " 'worker' strategy with --experimental_worker_multiplex. May be specified as "
- + " [name=value] to give a different value per worker mnemonic. Takes "
+ + "[name=value] to give a different value per mnemonic. The limit is based on worker "
+ + "keys, which are differentiated based on mnemonic, but also on startup flags and "
+ + "environment, so there can in some cases be more workers per mnemonic than this "
+ + "flag specifies. Takes "
+ ResourceConverter.FLAG_SYNTAX
+ ". 'auto' calculates a reasonable default based on machine capacity. "
+ "\"=value\" sets a default for unspecified mnemonics.",
