Improve and sync encoded graph cache options descriptions.

Author: mukel

compiler/src/org.graalvm.compiler.truffle.options/src/org/graalvm/compiler/truffle/options/PolyglotCompilerOptions.java

@@ -498,10 +498,10 @@ private String indent(int nameLength) {
     @Option(help = "Instrument branches by considering different inlining sites as different branches.", category = OptionCategory.INTERNAL) //
     public static final OptionKey<Boolean> InstrumentBranchesPerInlineSite = new OptionKey<>(false);
 
-    @Option(help = "Cache encoded graphs across compilations to speedup partial evaluation. (default: true).", usageSyntax = "true|false", category = OptionCategory.EXPERT) //
+    @Option(help = "Cache encoded graphs across Truffle compilations to speed up partial evaluation. (default: true).", usageSyntax = "true|false", category = OptionCategory.EXPERT) //
     public static final OptionKey<Boolean> EncodedGraphCache = new OptionKey<>(true);
 
-    @Option(help = "Delay, in milliseconds, after which the encoded graph cache is dropped when the compile queue becomes idle (default: 10000).", //
+    @Option(help = "Delay, in milliseconds, after which the encoded graph cache is dropped when a Truffle compiler thread becomes idle (default: 10000).", //
                     usageSyntax = "<ms>", category = OptionCategory.EXPERT) //
     public static final OptionKey<Integer> EncodedGraphCachePurgeDelay = new OptionKey<>(10_000);
 

truffle/docs/Options.md

@@ -56,8 +56,8 @@ They are useful to users and language and tool implementers.
 - `--engine.Compilation=true|false` : Enable or disable Truffle compilation.
 - `--engine.CompilerIdleDelay=<ms>` : Set the time in milliseconds an idle Truffle compiler thread will wait for new tasks before terminating. New compiler threads will be started once new compilation tasks are submitted. Select '0' to never terminate the Truffle compiler thread. The option is not supported by all Truffle runtimes. On the runtime which doesn't support it the option has no effect. default: 10000
 - `--engine.CompilerThreads=[1, inf)` : Manually set the number of compiler threads. By default, the number of compiler threads is scaled with the number of available cores on the CPU.
-- `--engine.EncodedGraphCache=true|false` : Cache encoded graphs across Truffle compilations to speedup partial evaluation (default: true).
-- `--engine.EncodedGraphCachePurgeDelay=<ms>` : Delay, in milliseconds, after which the encoded graph cache is dropped when the compile queue becomes idle. On runtimes which doesn't support it the option has no effect (default: 10000).
+- `--engine.EncodedGraphCache=true|false` : Cache encoded graphs across Truffle compilations to speed up partial evaluation. (default: true).
+- `--engine.EncodedGraphCachePurgeDelay=<ms>` : Delay, in milliseconds, after which the encoded graph cache is dropped when a Truffle compiler thread becomes idle (default: 10000).
 - `--engine.FirstTierBackedgeCounts=true|false` : Whether to emit look-back-edge counters in the first-tier compilations. (default: true)
 - `--engine.FirstTierCompilationThreshold=[1, inf)` : Minimum number of invocations or loop iterations needed to compile a guest language root in first tier under normal compilation load (default: 400).
 - `--engine.FirstTierMinInvokeThreshold=[1, inf)` : Minimum number of calls before a call target is compiled in the first tier (default: 1)