The C-c TAB binding in Org mode

[ntevenhere]

I confirm that...

• I searched the FAQ, issue tracker, discussions board, documentation, and wiki, and did not find an answer to my question.

• Any discussions with or conclusions derived from the use of LLMs will be omitted from my question.

What is your question?

How is C-c TAB not bound to what it says it does in the Org manual? In my setup C-c TAB is (somehow) bound to org-toggle-inline-images. According to the manual C-c TAB should let me shrink the size of org tables.

I was able to redefine the binding myself, but I'm still wondering what is doing this in the first place.

(define-key org-mode-map (kbd "C-c TAB") #'org-table-toggle-column-width)

Emacs 30.2 / Org mode version 9.8 / Doom latest

I can't find where the key is being defined. The Help for the binding doesn't have the information needed. (It also tells me that the function is obsolete)

M-x describe-key C-c <tab>

C-c TAB (translated from C-c <tab>) runs the command org-toggle-inline-images
(found in org-mode-map), which is an interactive native-comp-function in
‘org-compat.el’.

This function is obsolete since 9.8; use ‘org-link-preview’ instead.

It is bound to z i, <normal-state> z i and C-c TAB.

(org-toggle-inline-images &optional INCLUDE-LINKED BEG END)

Toggle the display of inline images.
INCLUDE-LINKED is passed to ‘org-display-inline-images’.

[back]

The binding is correct in Emacs -Q, so the culprit can only be somewhere in my config or Doom (but I don't find it in my config.el or custom.el).

Something possibly interesting is that Doom binds the org-display-inline-images function to C-c C-i, yet in the M-x describe-key output above C-c TAB is listed, but C-c C-i isn't! You can even do describe-key C-c C-i, and it'll take you to the same place. That's very strange to me.

Can't find any suspicious bindings with this grep command either:

$ grep -rn 'org-toggle-inline-images' .config/doom .config/emacs/.local/straight/repos/**/*org* .config/emacs/modules/lang/org | tee file
.config/emacs/.local/straight/repos/org/lisp/org-compat.el:1209:(make-obsolete 'org-toggle-inline-images
.config/emacs/.local/straight/repos/org/lisp/org-compat.el:1213:(defun org-toggle-inline-images (&optional include-linked beg end)
.config/emacs/.local/straight/repos/org/etc/ORG-NEWS:100:The old ~org-toggle-inline-images~ command is obsolete but still
.config/emacs/.local/straight/repos/org/etc/ORG-NEWS:105:  (org-defkey org-mode-map (kbd "C-c C-x C-v") #'org-toggle-inline-images))
.config/emacs/.local/straight/repos/org/etc/ORG-NEWS:583:This command replaces ~org-toggle-inline-images~, which is now
.config/emacs/.local/straight/repos/org-contrib/lisp/org-screenshot.el:262:display is already on (see \\[org-toggle-inline-images])
.config/emacs/.local/straight/repos/org-contrib/lisp/org-screenshot.el:262:display is already on (see \\[org-toggle-inline-images])
.config/emacs/.local/straight/repos/org/lisp/org-compat.el:1209:(make-obsolete 'org-toggle-inline-images
.config/emacs/.local/straight/repos/org/lisp/org-compat.el:1213:(defun org-toggle-inline-images (&optional include-linked beg end)
.config/emacs/modules/lang/org/config.el:784:        "C-c C-i"    #'org-toggle-inline-images
.config/emacs/modules/lang/org/config.el:1179:            :n "zi"  #'org-toggle-inline-images

System information

No response

[hlissner]

As of doomemacs/doomemacs@d2d805a this should be fixed.

The issue is that, due to historical reasons, Emacs cannot distinguish between C-i and TAB, so binding to one is equivalent to binding to the other. Doom adds a special <C-i> input event here, so that they can be distinguished, so I've moved the problematic keybind to that instead, which should revert C-c TAB back to its original command (org-ctrl-c-ctrl-c).

Thanks for bringing it to my attention!

[ntevenhere]

As always Henrik, you're a hero.