Cannot change mappings for a filetype / buffer

[pritchett]

I am trying to unmap conjures K binding for Lua files, since I would like to rely on the LSP hover functionality, especially since doc-word is not supported for lua.

The documentation states

You can also set `b:` prefixed versions of all configuration values for buffer
local settings that override their global counterparts.

so I tried setting
:let b:conjure#mapping#doc_word = v:false

and vim.b[(buffer number)]]["conjure#mapping#doc_word"] = false

but this appears to not be a valid b: variable name.

There doesn't appear to be any way to change this for a language or specific buffer, only for all conjure global mappings.

I was able to make a workaround by creating an auto command to set the keymap to execute vim.lsp.buf.hover again.

[russtoku]

Yes, you are correct that setting a buffer-local variable, conjure#mapping#doc_word, doesn't override Conjure's default mapping of K to doc-str. You should have seen an error message like:

E461: Illegal variable name: b:conjure#mapping#doc_word

when you ran:

:let b:conjure#mapping#doc_word = v:false

because underscores are not valid characters for Vimscript variables.

However, :he conjure-config says:

  You can disable a mapping entirely by setting it to v:false like so.

      :let g:conjure#mapping#doc_word = v:false

  These need to be set before you enter a relevant buffer since the mappings are
  defined as you enter a buffer and can't be altered after the fact.

For your immediate concern, you should be able to use this in your Neovim config (Note the syntax for Vimscript):

:let g:['conjure#mapping#doc_word'] = v:false

Then, when you edit any file type that Neovim is configured to support, the mapping of K won't be set by Conjure. And, if you have an LSP configured, its mapping of K to vim.lsp.buf.hover() should be active.

[russtoku]

This issue is like Issue #614. See also https://github.com/Olical/conjure#configuration (Issue #541).

[Olical]

Looking into this now and a couple of initial clarifications:

vim.b["conjure#mapping#doc_word"] = false

That should work if set early enough before BufEnter - it's not _ that's the issue, it might be # not being allowed in b: variables in VimL syntax I think? Might be some confusion here around - and _, it's hyphens that aren't allowed in Vim variable names, underscores should be fine everywhere (and so should # for that matter but I think there's some quirks there).

This is mostly a documentation gap I think, looking into it now but I admit that the BufEnter nature of mappings does make it tricky to override in a local way. It's easier to set up overrides nice and early globally but the buffer local ones get tricky.

[Olical]

Added some more docs for key bind control especially in certain filetypes. Hope that helps!