1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
The automatically generated patch puts this free form text on top of it.
If you are using gbp-buildpackage(1), you probably don't need this file.
If you are using dgit-maint-merge(7), please consider text as follows.
The Debian packaging of foo is maintained in git, using the merging workflow
described in dgit-maint-merge(7). There isn't a patch queue that can be
represented as a quilt series.
A detailed breakdown of the changes is available from their canonical
representation - git commits in the packaging repository. For example, to see
the changes made by the Debian maintainer in the first upload of upstream
version 1.2.3, you could use:
% git clone https://git.dgit.debian.org/foo
% cd foo
% git log --oneline 1.2.3..debian/1.2.3-1 -- . ':!debian'
(If you have dgit, use `dgit clone foo`, rather than plain `git clone`.)
A single combined diff, containing all the changes, follows.
--- caps2esc-0.3.2.orig/README.md
+++ caps2esc-0.3.2/README.md
@@ -25,8 +25,8 @@ ESC when pressed alone is quite handy, s
## Building
-```
-$ git clone git@gitlab.com:interception/linux/plugins/caps2esc.git
+```text
+$ git clone https://gitlab.com/interception/linux/plugins/caps2esc.git
$ cd caps2esc
$ cmake -B build -DCMAKE_BUILD_TYPE=Release
$ cmake --build build
@@ -34,10 +34,10 @@ $ cmake --build build
## Execution
-```
+```text
caps2esc - transforming the most useless key ever in the most useful one
-usage: caps2esc [-h] [-m mode] [-t delay]
+usage: caps2esc [-h | [-m mode] [-t delay]]
options:
-h show this message and exit
@@ -54,30 +54,29 @@ options:
```
`caps2esc` is an [_Interception Tools_][interception-tools] plugin. A suggested
-`udevmon` job configuration is:
+`udevmon` job configuration (check the [_Interception Tools_
+README][interception-tools] for alternatives) is:
```yaml
- JOB: intercept -g $DEVNODE | caps2esc | uinput -d $DEVNODE
DEVICE:
EVENTS:
EV_KEY: [KEY_CAPSLOCK, KEY_ESC]
-
```
For more information about the [_Interception Tools_][interception-tools], check
the project's website.
-## Mouse Support
+## Mouse/Touchpad Support
-After _Interception Tools_ 0.3.1, `caps2esc` can observe for mouse events. An
-example configuration taken from my laptop:
+After _Interception Tools_ 0.3.2, `caps2esc` can observe (or replace) mouse
+events. An example configuration taken from my laptop:
```yaml
SHELL: [zsh, -c]
---
-- JOB: >
- mux -c caps2esc;
- mux -i caps2esc | caps2esc | uinput -d /dev/input/by-path/platform-i8042-serio-0-event-kbd
+- CMD: mux -c caps2esc
+- JOB: mux -i caps2esc | caps2esc | uinput -c /etc/interception/keyboard.yaml
- JOB: intercept -g $DEVNODE | mux -o caps2esc
DEVICE:
LINK: /dev/input/by-path/platform-i8042-serio-0-event-kbd
@@ -87,22 +86,35 @@ SHELL: [zsh, -c]
```
For more information on the topic, check the [_Interception Tools_
-README][interception-tools] about usage of the `mux` tool and device specific
-setups, and [this discussion][issue-9-note] for more examples.
+README][interception-tools] about usage of the `mux` tool and hybrid virtual
+device configurations.
## Installation
+### Archlinux
+
It's available from [community](https://archlinux.org/packages/community/x86_64/interception-caps2esc/):
-```
+```text
$ pacman -S interception-caps2esc
```
-I don't use Ubuntu and recommend Archlinux instead, as it provides the AUR, so I
-don't maintain PPAs. For more information on Ubuntu/Debian installation check
-this:
+### Void Linux
+
+```text
+$ xbps-install -S caps2esc
+```
+
+### Ubuntu ([independent package][ubuntu])
+
+```text
+sudo add-apt-repository ppa:deafmute/interception
+sudo apt install interception-caps2esc
+```
+
+<sub>For debian and other derivatives you can download directly at https://launchpad.net/~deafmute/+archive/ubuntu/interception/+packages.</sub>
-- <https://askubuntu.com/questions/979359/how-do-i-install-caps2esc>
+[ubuntu]: https://gitlab.com/interception/linux/tools/-/issues/38
## Caveats
@@ -155,5 +167,4 @@ Copyright © 2017 Francisco Lopes da Sil
[x]: https://www.x.org
[interception]: https://github.com/oblitum/Interception
[interception-tools]: https://gitlab.com/interception/linux/tools
-[issue-9-note]: https://gitlab.com/interception/linux/plugins/caps2esc/-/issues/9#note_474942893
[key-repeat-fix]: https://github.com/oblitum/caps2esc/issues/1
--- caps2esc-0.3.2.orig/caps2esc.c
+++ caps2esc-0.3.2/caps2esc.c
@@ -18,7 +18,7 @@ void print_usage(FILE *stream, const cha
fprintf(stream,
"caps2esc - transforming the most useless key ever in the most useful one\n"
"\n"
- "usage: %s [-h] [-m mode] [-t delay]\n"
+ "usage: %s [-h | [-m mode] [-t delay]]\n"
"\n"
"options:\n"
" -h show this message and exit\n"
@@ -68,6 +68,7 @@ void write_event_with_mode(struct input_
int main(int argc, char *argv[]) {
int mode = 0, delay = 20000;
+
for (int opt; (opt = getopt(argc, argv, "ht:m:")) != -1;) {
switch (opt) {
case 'h':
|
