Preparing release

Author: houmain

CHANGELOG.md

@@ -3,6 +3,103 @@
 All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [Version 4.9.0] - 2024-11-15
+
+### Added
+
+- Added builtin macro `default` (#176).
+- Added macro actual parameter `$$` (#176).
+- Added builtin macro apply (#177).
+- Added `@macos-iso-keyboard` directive.
+- `keymapperctl --type` expands `$(commands)` under Windows.
+
+### Changed
+
+- Updated Karabiner VirtualHIDDevice to version 5.0.0 (#178).
+- Looking for config in `$XDG_CONFIG_HOME` first (#180).
+- Deprecated `;` as start of comment.
+
+### Fixed
+
+- Fixed build on MacOS (#179).
+- Improved coexistence with Karabiner-Elements (#172).
+- Fixed invalid index lookup on null object in KWin script.
+
+## [Version 4.8.2] - 2024-09-02
+
+### Added
+- Added logical key `Alt`.
+
+### Changed
+- Allow to override keys with aliases. e.g. 
+   ```
+   Alt = AltLeft
+   AltGr = AltRight
+   ```
+
+## [Version 4.8.1] - 2024-09-05
+
+### Added
+
+- Added [@forward-modifiers](https://github.com/houmain/keymapper?tab=readme-ov-file#directives) directive (#174).
+- Implemented `grab-device` directive support on MacOS (#166).
+
+## [Version 4.8.0] - 2024-09-01
+
+### Added
+
+- Added `keymapperctl` operations `--input` and `--output` for injecting key presses. e.g.: 
+
+    ```
+    keymapperctl --input Shift{A} B C
+    ```
+    with `--input` the mappings are applied as if the sequence came from an input device,
+    with `--output` the sequence is output as if it was generated by keymapper (#170).
+
+## [Version 4.7.3] - 2024-08-31
+
+### Fixed
+
+- Fixed mouse wheel breaking `?` input expressions.
+
+## [Version 4.7.2] - 2024-08-24
+
+### Added
+
+- Added `WheelLeft` and `WheelRight` for horizontal mouse wheels.
+
+### Changed
+
+- Swapped `WheelUp` and `WheelDown` on Windows.
+
+### Fixed
+
+- Fixed leaking of unmapped mouse input on Windows.
+
+## [Version 4.7.1] - 2024-08-19
+
+### Added
+
+- Added string interpolation, which works in strings, terminal commands and regular expressions. e.g.:
+    ```bash
+    VAR = "World"
+    A >> "Hello ${VAR}"  # $VAR also works
+    ```
+
+- Allow to split a line with a `\` at the end. e.g.:
+    ```bash
+    Shift{A} >> \
+       Control{B}
+    ```
+
+### Changed
+
+- Aliases are no longer automatically substituted in terminal commands (use string interpolation).
+
+### Fixed
+
+- Fixed too eager macro evaluation.
+
 ## [Version 4.7.0] - 2024-08-17
 
 ### Added
@@ -647,6 +744,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## [Version 1.1.5] - 2020-05-09
 
+[version 4.9.0]: https://github.com/houmain/keymapper/compare/4.8.2...4.9.0
+[version 4.8.2]: https://github.com/houmain/keymapper/compare/4.8.1...4.8.2
+[version 4.8.1]: https://github.com/houmain/keymapper/compare/4.8.0...4.8.1
+[version 4.8.0]: https://github.com/houmain/keymapper/compare/4.7.3...4.8.0
+[version 4.7.3]: https://github.com/houmain/keymapper/compare/4.7.2...4.7.3
+[version 4.7.2]: https://github.com/houmain/keymapper/compare/4.7.1...4.7.2
+[version 4.7.1]: https://github.com/houmain/keymapper/compare/4.7.0...4.7.1
 [version 4.7.0]: https://github.com/houmain/keymapper/compare/4.6.0...4.7.0
 [version 4.6.0]: https://github.com/houmain/keymapper/compare/4.5.2...4.6.0
 [version 4.5.2]: https://github.com/houmain/keymapper/compare/4.5.1...4.5.2

README.md

@@ -311,7 +311,7 @@ print = $(echo $0 $1 >> ~/keymapper.txt)
 F1 >> print["pressed the key", F1]
 ```
 
-There are a few builtin macros `repeat[EXPR, N]`, `length[STR]`, `default[A, B]`, `add/sub/mul/div/mod/min/max[A, B]` which allow to define some more advanced macros. e.g:
+There are a few builtin macros `repeat[EXPR, N]`, `length[STR]`, `default[A, B]`, `apply[EXPR, ARGS...]`, `add/sub/mul/div/mod/min/max[A, B]` which allow to generate mappings and define some more advanced macros. e.g:
 
 ```bash
 # when last character of string is typed, undo using backspace and output new string
@@ -324,6 +324,9 @@ substituteExec = ? "$0" >> \
 
 substitute["Cat", "Dog"]
 substituteExec[":whoami", "whoami"]
+
+# add a `FN >> Meta{N}` mapping for each function key
+apply[F$0 >> Meta{$0}, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
 ```
 
 `$$` is substituted with the actual parameter count, which allows to add overloads: