Undocumented functionality?

[itepechi]

The keymaps "<c-g%>", "<Plug>(matchup-c_g%)", and the function matchup#motion#insert_mode() aren't mentioned in the documentation or even in the issues. Is this functionality still meant to be used, or is it deprecated?

Because I wanted to use it, but found its behavior to be very buggy, e.g. it can jump into parens/brackets/braces but can't jump out if the character after the opening match is not a newline or a whitespace, ignores any other matches etc.

[andymass]

It is basically supported, the missing documentation was an oversight.
Can you produce an example which shows the failure? Then I can try to fix it.

[itepechi]

Sure, here is an example:

Example file

-- NOTE: Every key sequence starts with normal mode.
-- NOTE: The empty comments were added to preserve whitespace and are unrelated to the issue.
-- NOTE: The final `return _` is added to silence the diagnostics and is unrelated to the issue.

---- Paren/bracket/brace matches ----

local _ = { ["foo"] = "bar" } --
--                           ^ You can jump from here using `i<C-g>%`
--         ^ to here.

local _ = { ["foo"] = "bar" } --
--         ^ You can jump back from here using `i<C-g>%`
--                           ^ to here.

local _ = { ["foo"] = "bar" } --
--                 ^ You can jump from here using `i<C-g>%`
--           ^ to here.

local _ = { ["foo"] = "bar" } --
--           ^ But you can't jump back from here using `i<C-g>%`
--                 ^ to here.

---- Non-paren/bracket/brace matches ----

local _ = "foo bar" --
--        ^^      ^^ None of these cursor positions allows you to jump around using `i<C-g>%`. (This might be the intended behavior.)

local _ = function()
  --      ^^^^^^^^^ None of these cursor positions allows you to jump around using `i<C-g>%`. (This might be the intended behavior.)
  return nil
end

return _

-- vim:et:ts=2:sw=2

Minimal VIMRC (not required to reproduce)

vim.env.LAZY_STDPATH = ".repro"
load(
	vim.fn.system(
		"curl -s https://raw.githubusercontent.com/folke/lazy.nvim/306a05526ada86a7b30af95c5cc81ffba93fef97/bootstrap.lua"
	)
)()

require("lazy.minit").repro({
	spec = {
		{
			"andymass/vim-matchup",
			dependencies = { "nvim-treesitter/nvim-treesitter" },
			lazy = false,
		},
	},
})

require("nvim-treesitter").install({ "lua" })