On 2022-07-10, haron13-2019 wrote: > When skimming over documentation it is easy to erroneously believe one can use > ":3mat" command - see my recent bug report #10690 instantly closed by > @chrisbra > )))) > > Thinking about it a bit, may be this is good idea to officially remove ":3mat" > from the documentation. For normal use cases it is anyway not (really) > available, it can be only used (as far as I understood) only in some exotic > circumstances - for example that standard matchit plugin is deactivated? > > Another "improvement" - documentation encourages plugin authors to use > ":2mat". > Is it not better to leave ":mat" and ":2mat" for interactive usage entirely > and > ask plugin authors to use matchadd() call directly?
I think your change goes too far. The :3match command _does_ exist and it _can_ be used. In fact, it _is_ used, by the matchparen plugin. I don't think that hiding it or pretending that it doesn't exist benefits the user. I certainly would not remove the mentions of the matchparen plugin. For example, matcharg(3) returns a different result than matcharg(4) and :3match will work while :4match will fail. This could be confusing to the user without an discoverable explanation. The semi-reserved status of match ID 3 should be mentioned in a few more places, such as ":help matchadd()", but I would not remove any of the existing documentation on it. Regards, Gary -- -- You received this message from the "vim_dev" maillist. Do not top-post! Type your reply below the text you are replying to. For more information, visit http://www.vim.org/maillist.php --- You received this message because you are subscribed to the Google Groups "vim_dev" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/vim_dev/20220710225006.GF12539%40phoenix.
