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
|
This document contains a description of major design iterations.
It is not intended to be exhaustive.
# v2.3.0-rc
This is a major release which breaks backward compatibility for
non-trivial configs (we are still in beta after all :P).
In the absence of too much blowback, this will probably become the final
v2 design.
Much of this harkens back to v1, with some additional simplifications
and enhancements.
## Notable changes:
- Introduced composite layers
- Eliminated sequences in favour of macros (C-x is now just syntactic
sugar for macro(C-x)).
- Actions which previously accepted sequences as a second argument
now accept macros of any kind.
- General stability/speed/memory improvements
- Made the man page less war and peacey
## Non backward-compatible changes
- Replaced three arg overload() with a more flexible timeout() mechanism
- Layers are now fully transparent. That is, bindings are drawn on the basis
of activation order with [main] being active by default.
- Modifiers now apply to all bindings with the exception of modifiers
associated with the active layer.
Rationale:
The end result is more intuitive and in conjunction with transparency
allows modifiers to be paired with layer entries without having
to use layer nesting (#103).
E.G
```
capslock = layer(nav)
[nav:C]
h = left
l = right
```
will cause `capslock+h` to produce `left` (rather than `C-left`), while
`control+capslock+h` will produce `C-left`, as one might intuit.
- Abolished layer types. Notably, the concept of a 'layout' no longer exists.
Rationale:
This simplifies the lookup logic, elminates the need for dedicated layout
actions, and makes it easier to define common bindings for letter layouts
since the main layer can be used as a fallback during lookup.
E.G
[main]
capslock = layer(capslock)
[dvorak]
a = a
s = o
...
[capslock]
1 = toggle(dvorak)
- Special characters within macros like ) and \ must be escaped with a backslash.
- Modifier sequences (e.g `C-M`) are no longer valid layers by default.
Rationale:
This was legacy magic from v1 which added a bunch of cruft to the code and
seemed to cause confusion by blurring the boundaries between layers and
modifiers. Similar results can be achieved by explicitly defining an
empty layer with the desired modifier tags:
I.E
a = layer(M-C)
b = layer(M)
becomes
a = layer(meta-control)
b = layer(meta)
[meta-control:M-C]
Note that in the above sample "meta" does not need to be
explicitly defined, since full modifier names are still
mapped to their eponymously named layers.
- Eliminated -d
Rationale:
Modern init systems are quite adept at daemonization, and the end user
can always redirect/fork using a wrapper script if desired.
- Eliminated reload on SIGUSR1
Rationale:
Startup time has been reduced making the cost of a full
restart negligible (and probably more reliable).
|
