You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@groovy.apache.org by su...@apache.org on 2021/08/29 09:05:58 UTC

[groovy] branch master updated: Tweak doco

This is an automated email from the ASF dual-hosted git repository.

sunlan pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/groovy.git


The following commit(s) were added to refs/heads/master by this push:
     new 6178149  Tweak doco
6178149 is described below

commit 617814973ca1683f84e34daca6e6c951ffccdc10
Author: Daniel Sun <su...@apache.org>
AuthorDate: Sun Aug 29 17:05:17 2021 +0800

    Tweak doco
---
 src/spec/doc/performance-guide.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/spec/doc/performance-guide.adoc b/src/spec/doc/performance-guide.adoc
index e8e1e76..2131332 100644
--- a/src/spec/doc/performance-guide.adoc
+++ b/src/spec/doc/performance-guide.adoc
@@ -28,6 +28,6 @@ The Parrot parser is based on antlr4 and introduced since Groovy 3.0.0. It provi
 | Option | Description | Default | Version | Example
 | groovy.parallel.parse | Parsing groovy source file in parallel. | `false` util Groovy 4.0.0 | 3.0.5+ | -Dgroovy.parallel.parse=true
 | groovy.antlr4.cache.threshold | antlr4 relies on DFA cache heavily for better performance, so antlr4 will not clear DFA cache, thus OutOfMemoryError will probably occur. Groovy trades off parsing performance and memory usage, when the count of Groovy source files parsed hits the cache threshold, the DFA cache will be cleared. *Note:* `0` means never clearing DFA cache, so requiring bigger JVM heap size. Or set a greater value, e.g. 200 to clear DFA cache if threshold hits. **Note: ** t [...]
-| groovy.antlr4.sll.threshold | Parrot parser will try SLL mode and then try LL mode if SLL failed. But the more tokens to parse, the more likely SLL will fail. If SLL threshold hits, SLL will be skipped. **Note: ** the threshold specified is the token count | -1 (disabled by default) | 3.0.9+ | -Dgroovy.antlr4.sll.threshold=1000
+| groovy.antlr4.sll.threshold | Parrot parser will try SLL mode and then try LL mode if SLL failed. But the more tokens to parse, the more likely SLL will fail. If SLL threshold hits, SLL will be skipped. Setting the threshold to `0` means never trying SLL mode, which is not recommended at most cases. **Note: ** the threshold specified is the token count | -1 (disabled by default) | 3.0.9+ | -Dgroovy.antlr4.sll.threshold=1000
 | groovy.antlr4.clear.lexer.dfa.cache | Clear the DFA cache for lexer. The DFA cache for lexer is always small and important for parsing performance, so it's strongly recommended to leave it as it is util OutOfMemoryError will truely occur | `false`| 3.0.9+ | -Dgroovy.antlr4.clear.lexer.dfa.cache=true
 |=======================================================================