[vim/vim] Update doc to suggest using () instead of ; when using <Plug> mappings (PR #20351)
Enrico Maria De Angelis
I'm attempting to gather consensus and, if gathered, apply an improvement of the doc as regards the suggestion - found at :help using-<Plug> - of using (-) delimiters instead of ; terminator.
The matter surfaced on vi.stackexchange, see @romainl 's answer and N.W.'s comment.
You can view, comment on, or merge this pull request online at:
https://github.com/vim/vim/pull/20351
Commit Summary
- 405243d Update doc to suggest using () instead of ; when using <Plug> mappings
File Changes
(1 file)
- M runtime/doc/usr_51.txt (30)
Patch Links:
—
Reply to this email directly, view it on GitHub, or unsubscribe.
Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS and Android. Download it today!
You are receiving this because you are subscribed to this thread.
Christian Brabandt
chrisbra left a comment (vim/vim#20351)I think this makes sense, thanks
—
Reply to this email directly, view it on GitHub, or unsubscribe.
Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS and Android. Download it today!
You are receiving this because you are subscribed to this thread.
Romain Lafourcade
romainl left a comment (vim/vim#20351)What I meant to say in the linked answer was that what comes after <Plug> is 100% arbitrary. It doesn't have to be in PascalCase. It doesn't have to end with a "terminator". It doesn't have to be wrapped in parentheses or anything. It doesn't have to be legible or short or make any kind of sense. It's just whatever the person who create that mapping came up with.
Using a specific "terminator", wrapping the name in a pair or characters, using PascalCase to separate the plugin name from the functionality… it's all just tricks.
And I think that the doc could be a little bit more transparent about that.
—
Reply to this email directly, view it on GitHub, or unsubscribe.
Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS and Android. Download it today!
You are receiving this because you are subscribed to this thread.
Christian Brabandt
chrisbra left a comment (vim/vim#20351)I made it a bit more clear
—
Reply to this email directly, view it on GitHub, or unsubscribe.
Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS and Android. Download it today!
You are receiving this because you are subscribed to this thread.