From: Yuan Fu <casouri@gmail.com>
Date: Thu, 14 Sep 2023 00:56:07 +0000 (-0700)
Subject: Add tree-sitter performance note
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=c916f471caada4eb9a4b7f9f53925a71525c694a;p=emacs.git

Add tree-sitter performance note
---

diff --git a/admin/notes/tree-sitter/performance b/admin/notes/tree-sitter/performance
new file mode 100644
index 00000000000..0e8351403af
--- /dev/null
+++ b/admin/notes/tree-sitter/performance
@@ -0,0 +1,12 @@
+TREE-SITTER PERFORMANCE NOTES -*- org -*-
+
+* Facts
+
+Incremental parsing of a few characters worth of edit usually takes
+less than 0.1ms. If it takes longer than that, something is wrong.  There’s one time where I found tree-sitter-c takes ~30ms to incremental parse. Updating to the latest version of tree-sitter-c solves it, so I didn’t investigate further.
+
+The ranges set for a parser doesn’t grow when you insert text into a
+range, so you have to update the ranges every time before
+parsing. Fortunately, changing ranges doesn’t invalidate incremental
+parsing, so there isn’t any performance lost in update ranges
+frequently.