Skip to content

FR: make key bindings for choose-tree, choose-buffer, customize-mode, etc self-documenting #4357

@ilyagr

Description

@ilyagr

I wish it was possible to see the bindings for commands like choose-tree without having to search through the man page every time. Ideally, they would be discoverable from the choose-xxx interface. This could use a binding, or a special entry in the list that shows help in the preview window.

It's not immediately clear what the best binding is. F1 is probably good. The F keys are, these days, hard to access on some keyboards, so it'd be nice to have an additional binding. In Vim mode, ? and h are taken, but c-h and/or c-/ would work.

In any case, the first step might be to have an option to tmux list-keys, e.g. tmux lsk -c choose-tree, that lists the bindings for such commands.


An alternative approach would be to make the docs (currently in the man page) for choose-xxx commands (or for all commands) easier to reach. E.g., they could be reachable with tmux lscm -h choose-buffer or man tmux-choose-buffer or tmux man choose-buffer | man -. This deserves a whole separate FR, though; the main obstacle here seems to be how to do it portably and without increasing the maintenance burden.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions