@@ -356,19 +356,22 @@ impl<'a> CapturedNode<'a> {
356
356
357
357
/// The number of matches a TS cursor can at once to avoid performance problems for medium to large files.
358
358
/// Set with `set_match_limit`.
359
- /// Using such a limit means that we loose valid captures in so there is fundementally a tradeoff here.
359
+ /// Using such a limit means that we loose valid captures in, so there is fundamentally a tradeoff here.
360
+ ///
360
361
///
361
362
/// Old tree sitter versions used a limit of 32 by default until this limit was removed in version `0.19.5` (must now best set manually).
362
- /// However this causes performance issues for medium to large files.
363
- /// In helix this problem caused textobjt motions to take multiple seconds to complete in medium sized rust files (3k loc).
363
+ /// However, this causes performance issues for medium to large files.
364
+ /// In helix, this problem caused treesitter motions to take multiple seconds to complete in medium- sized rust files (3k loc).
364
365
/// Neovim also encountered this problem and reintroduced this limit after it was removed upstream
365
- /// (see https://github.com/neovim/neovim/issues/14897 and https://github.com/neovim/neovim/pull/14915).
366
- /// The number used here is fundementally a tradeoff between breaking some obscure edgecases and performance.
366
+ /// (see <https://github.com/neovim/neovim/issues/14897> and <https://github.com/neovim/neovim/pull/14915>).
367
+ /// The number used here is fundamentally a tradeoff between breaking some obscure edge cases and performance.
368
+ ///
367
369
///
368
- /// 64 was choosen because neovim uses that value.
369
- /// It has been choosen somewhat arbitrarly (https://github.com/neovim/neovim/pull/18397) mostly based
370
- /// upon how many issues occur in practice.
371
- /// So this could be changed if we ran into problems.
370
+ /// A value of 64 was chosen because neovim uses that value.
371
+ /// Neovim chose this value somewhat arbitrarily (<https://github.com/neovim/neovim/pull/18397>) adjusting it whenever issues occur in practice.
372
+ /// However this value has been in use for a long time and due to the large userbase of neovim it is probably a good choice.
373
+ /// If this limit causes problems for a grammar in the future, it could be increased.
374
+
372
375
const TREE_SITTER_MATCH_LIMIT : u32 = 64 ;
373
376
374
377
impl TextObjectQuery {
0 commit comments