Add desc to orgmode keymap

[danielnehrig]

Does this feature exist in Emacs orgmode core?

N/A

Orgmode link

No response

Feature value

Which Key access the "desc" property to display set keymaps
it would be great to have proper descriptions for orgmode mappings

vim.keymap.set(mode, command, { desc = "Description of the mapping" })

Additional context

No response

[jgollenz]

Does (n)vim expose a way to access the desc for all keymaps that are currently set?

[jgollenz]

Oh, you mean this Which-Key, right? Sure, we could add that 👍

[jgollenz]

@kristijanhusak this can be done via the multi-mode mappings I added:

    org_insert_todo_heading_respect_content = {
        n = {
            callback = 'org_mappings.insert_todo_heading_respect_content',
            args = {},
            opts = { desc = "foobar" },
        },
    },

buuuut doing that for every command is a bit overkill on how large that file should be. I propose to either:

1. allow that special case in mappings.org: org_insert_todo_heading_respect_content = { org_mappings.insert_todo_heading_respect_content', desc = "foobar" }

2. put the information into defaults.lua, as this is already the place where you put that information now:
   org_insert_todo_heading_respect_content = { <Leader>oit', "Add new todo headline after current heading block on same level" }

I think option two is more sensible