Allow bundling parentheses into clusters to provide more flexibility and deal with more complex occasions

[senioria]

(This pr is the successor of #175)
(Currently this is only a draft since its documents are not yet updated)

As introduced in #174 and #161, some languages may have different syntax for parentheses inside and outside some environments; though they can be solved without adding any features, there are some issues beyond the issue themselves. Typically, a solution is adding a new vim syntax matching the special region, and define the parentheses to be containedin them. The shortcoming of the solution is that the environment itself (usually would be considered as parentheses) can't be rainbowed, and the parentheses inside the environment would have its rainbow level reset to 0.

This patch offers a way to solve these within rainbow. By bundling the toplevel parentheses, the region markers, and the parentheses within the regions into different clusters and assigning correct containing relation for them, they can cascade and all be rainbowed in correct levels.

However, after all, the patch may add too much complexity to rainbow... If this feature is considered worthwhile to be introduced into rainbow, Senioria will update the documents...

[CoelacanthusHex]

Considering rainbow.vim not too heavy, and this plugin is used to indicate syntax units.
So I think accuracy is more important than speed.

[senioria]

But every huge project is piled up with such not-too-heavy pieces... Senioria think this unnecessary because there may be nobody relying on the rainbow color level to distinguish the nesting level and this is not a good practice; furthermore, it seems that few people had ever desired handle all parentheses in rainbow or have such accuracy... And once the feature is added, whether it's used or not, the cost it introduces exist and it should be kept for the sake of compatibility... After all, efficiency is not the most important point: there are too many plugins consuming much more time, and the limited complexity of languages ensured rainbow just need to process a rather small set of rules at startup.

…

On Sun, Dec 05, 2021 at 12:06:57AM -0800, Coelacanthus wrote: Considering rainbow.vim not too heavy, and this plugin is used to indicate syntax units. So I think **accuracy is more important than speed.** -- You are receiving this because you authored the thread. Reply to this email directly or view it on GitHub: #176 (comment)

[senioria]

However, the issues this pr intended to fix is not actually fixed yet, because it remains uncertain how shell codes and html templates should be highlighted...