aboutsummaryrefslogtreecommitdiff
path: root/assets/outbox/2026-05-18-handoff-from-dotemacs-tmux-copy-mode-keys.org
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-20 14:48:49 -0400
committerCraig Jennings <c@cjennings.net>2026-05-20 14:48:49 -0400
commitc24174f811ad5ffca1a3454013b55127df50ff3c (patch)
tree7ba34eb6462cf46efb352c1c0dbc7a4daa70ce17 /assets/outbox/2026-05-18-handoff-from-dotemacs-tmux-copy-mode-keys.org
parent926a9a3e34557b259394c25ca8d10c675438515d (diff)
downloadarchsetup-c24174f811ad5ffca1a3454013b55127df50ff3c.tar.gz
archsetup-c24174f811ad5ffca1a3454013b55127df50ff3c.zip
chore: clean dead todo.org doc-links and file three docs to outbox
I removed three dead `file:` links in todo.org. They pointed at docs that were never written: testing-strategy.org, firmware-cleanup.org, and PLAN-browser-themes.org. Each task body already carries that content inline, so the links were dead weight. I also reworded the Testinfra task's lead-in that claimed the testing-strategy doc exists. I filed three resolved reference docs into assets/outbox/: the calendar-sync scrub note, the tmux copy-mode handoff, and the 2026-05-19 lint follow-up report.
Diffstat (limited to 'assets/outbox/2026-05-18-handoff-from-dotemacs-tmux-copy-mode-keys.org')
-rw-r--r--assets/outbox/2026-05-18-handoff-from-dotemacs-tmux-copy-mode-keys.org59
1 files changed, 59 insertions, 0 deletions
diff --git a/assets/outbox/2026-05-18-handoff-from-dotemacs-tmux-copy-mode-keys.org b/assets/outbox/2026-05-18-handoff-from-dotemacs-tmux-copy-mode-keys.org
new file mode 100644
index 0000000..c3e46b4
--- /dev/null
+++ b/assets/outbox/2026-05-18-handoff-from-dotemacs-tmux-copy-mode-keys.org
@@ -0,0 +1,59 @@
+#+TITLE: tmux copy-mode keys aligned with Emacs vterm-copy-mode
+#+DATE: 2026-05-18
+
+* Source
+
+Authored from a =~/.emacs.d= session. Edit lives in this repo because
+=~/.tmux.conf= is the stowed symlink target.
+
+* Change
+
+Added a copy-mode key block to =dotfiles/common/.tmux.conf= (just below
+=set -g status-keys emacs=) to mirror the Emacs
+=cj/vterm-tmux-history= / =vterm-copy-mode= ergonomics in
+=~/.emacs.d/modules/vterm-config.el=:
+
+#+begin_src tmux
+bind-key -T copy-mode M-w send-keys -X copy-selection
+bind-key -T copy-mode C-g send-keys -X cancel
+unbind-key -T copy-mode Enter
+#+end_src
+
+Behavior:
+
+- =M-w= copies the selection and stays in copy-mode, so multiple
+ selections can be grabbed in a row. tmux's default copied and then
+ exited via =copy-selection-and-cancel=.
+- =C-g= now exits copy-mode (tmux's default was =clear-selection=).
+- =Enter= is unbound so RET has no "copy and exit" shortcut. The
+ Emacs side removes RET from =vterm-copy-mode-map= for the same
+ reason — one consistent way to leave the buffer.
+
+Defaults retained:
+- =q= and =Escape= already cancel.
+- =Space= still begins selection.
+
+* Why
+
+The Emacs side already aligned =vterm-copy-mode= and
+=cj/vterm-tmux-history= on one key story (commentary block at the top
+of =modules/vterm-config.el=). When tmux runs inside vterm, the user
+also lands in tmux's copy-mode (via the auto-enter on mouse wheel-up,
+line 10), so without this change the third surface had a different
+key story — Enter exits, M-w exits, C-g clears rather than cancels.
+
+* Activation
+
+After pulling and re-stowing on each machine:
+
+#+begin_src bash
+tmux source-file ~/.tmux.conf
+#+end_src
+
+Or in a live tmux session: =prefix r= (configured at line 53 of the
+conf).
+
+* Status
+
+Edited and saved. Not yet committed in =archsetup=. Craig confirms
+the keys work, then commits at his discretion.