Skip to content

Document <D-...> modifier and macOS Ctrl/Cmd behavior in keys.config#1613

Open
moritzketzer wants to merge 1 commit into
ahrm:developmentfrom
moritzketzer:docs/keys-config-modifier-tokens
Open

Document <D-...> modifier and macOS Ctrl/Cmd behavior in keys.config#1613
moritzketzer wants to merge 1 commit into
ahrm:developmentfrom
moritzketzer:docs/keys-config-modifier-tokens

Conversation

@moritzketzer

Copy link
Copy Markdown

pdf_viewer/input.cpp accepts C, D, A, S as modifier tokens,
but the syntax-help block at the top of pdf_viewer/keys.config only
shows <C-...> and <A-...>. <D-...> (command/meta) is
undiscoverable without reading the parser.

On macOS this matters: <C-k> binds to physical Control,
<D-k> binds to physical Command (⌘) — a Mac user expecting ⌘C from
copy <C-c> gets physical Ctrl+C instead.

Doc-only change to the comment block.

Copilot AI review requested due to automatic review settings May 18, 2026 11:24

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds documentation in the keys configuration file to describe the new <D-k> (Command/Meta key) modifier syntax and clarifies the behavior of Ctrl vs Command modifiers on macOS.

Changes:

  • Documents the <D-k> syntax for the macOS Command/meta modifier.
  • Adds a note explaining how <C-k> and <D-k> map to physical keys on macOS.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread pdf_viewer/keys.config
Comment on lines +15 to +16
# Note: on macOS, Qt swaps Ctrl and Cmd by default (see Qt::AA_MacDontSwapCtrlAndMeta),
# so <C-k> binds to the physical Control key and <D-k> binds to the physical Command (⌘) key.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants