[PR #1349] [MERGED] Add a spec draft for Keybindings Arguments #24597

Open
opened 2026-01-31 09:04:16 +00:00 by claunia · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/microsoft/terminal/pull/1349
Author: @zadjii-msft
Created: 6/20/2019
Status: Merged
Merged: 8/16/2019
Merged by: @zadjii-msft

Base: masterHead: dev/migrie/s/1142-keybindings-args


📝 Commits (6)

  • 784528f Add a spec draft for Keybindings Arguments.
  • 4d5eb54 Apply suggestions from code review
  • 47f6e25 Merge branch 'master' into dev/migrie/s/1142-keybindings-args
  • dd03ced Include notes on reliability, security, and Handleing Keybinding Args
  • 56d042a Add some extra details from review
  • f326ce6 Updating spec to remove the bulk of the IActionArgs and IActionEventArgs implementations, as they're redundant.

📊 Changes

1 file changed (+362 additions, -0 deletions)

View changed files

doc/cascadia/Keybindings-Arguments.md (+362 -0)

📄 Description

Summary of the Pull Request

The goal of this change is to both simplify the keybindings, and also enable far
more flexibility when editing a user's keybindings.

Currently, we have many actions that are very similar in implementation - for
example, newTabProfile0, newTabProfile1, newTabProfile2, etc. All these
actions are fundamentally the same function. However, we've needed to define 9
different actions to enable the user to provide different values to the newTab
function.

With this change, we'll be able to remove these essentially duplicated events,
and allow the user to specify arbitrary arguments to these functions.

References

Might play into #968, since there's some discussion of to munge or not to munge with the default keybinding for copy. This would make it easy to add both.

PR Checklist

Detailed Description of the Pull Request / Additional comments

Just read the spec :)

Validation Steps Performed

It's a spec.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/microsoft/terminal/pull/1349 **Author:** [@zadjii-msft](https://github.com/zadjii-msft) **Created:** 6/20/2019 **Status:** ✅ Merged **Merged:** 8/16/2019 **Merged by:** [@zadjii-msft](https://github.com/zadjii-msft) **Base:** `master` ← **Head:** `dev/migrie/s/1142-keybindings-args` --- ### 📝 Commits (6) - [`784528f`](https://github.com/microsoft/terminal/commit/784528f00879910b398f95ec396cea3953a4324f) Add a spec draft for Keybindings Arguments. - [`4d5eb54`](https://github.com/microsoft/terminal/commit/4d5eb54015328d5993f925cacb12a6182b97c06f) Apply suggestions from code review - [`47f6e25`](https://github.com/microsoft/terminal/commit/47f6e25ffd0c19f226b1038ad5c8c30a50619e12) Merge branch 'master' into dev/migrie/s/1142-keybindings-args - [`dd03ced`](https://github.com/microsoft/terminal/commit/dd03ced38272443e1ae3078c948ffcbea2287b23) Include notes on reliability, security, and `Handle`ing Keybinding Args - [`56d042a`](https://github.com/microsoft/terminal/commit/56d042a5c748c0a4362899c61c1153653d91f403) Add some extra details from review - [`f326ce6`](https://github.com/microsoft/terminal/commit/f326ce69602b21d7cbe5842f2bad4aca8185e21e) Updating spec to remove the bulk of the `IActionArgs` and `IActionEventArgs` implementations, as they're redundant. ### 📊 Changes **1 file changed** (+362 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `doc/cascadia/Keybindings-Arguments.md` (+362 -0) </details> ### 📄 Description <!-- Enter a brief description/summary of your PR here. What does it fix/what does it change/how was it tested (even manually, if necessary)? --> ## Summary of the Pull Request The goal of this change is to both simplify the keybindings, and also enable far more flexibility when editing a user's keybindings. Currently, we have many actions that are very similar in implementation - for example, `newTabProfile0`, `newTabProfile1`, `newTabProfile2`, etc. All these actions are _fundamentally_ the same function. However, we've needed to define 9 different actions to enable the user to provide different values to the `newTab` function. With this change, we'll be able to remove these _essentially_ duplicated events, and allow the user to specify arbitrary arguments to these functions. <!-- Other than the issue solved, is this relevant to any other issues/existing PRs? --> ## References Might play into #968, since there's some discussion of _to munge or not to munge_ with the default keybinding for copy. This would make it easy to add _both_. <!-- Please review the items on the PR checklist before submitting--> ## PR Checklist * [x] Specs #1142 <!-- Provide a more detailed description of the PR, other things fixed or any additional comments/features here --> ## Detailed Description of the Pull Request / Additional comments Just read the spec :) <!-- Describe how you validated the behavior. Add automated tests wherever possible, but list manual validation steps taken as well --> ## Validation Steps Performed It's a spec. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
claunia added the pull-request label 2026-01-31 09:04:16 +00:00
Sign in to join this conversation.
No Label pull-request
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#24597