From 17a6687fdde05c528891b8feea0a9ce8f4a0d9bf Mon Sep 17 00:00:00 2001 From: Manna Harbour <51143715+manna-harbour@users.noreply.github.com> Date: Wed, 28 Feb 2024 10:23:27 +1100 Subject: [PATCH] Update branches docs and build examples - Use branch directly by default - Attempt automatic merge if desired - If conflicts - Build from branch directly - Request rebase from maintainer --- .../workflows/build-example-mousekeyspr.yml | 4 +-- .github/workflows/build-example-suspend.yml | 2 +- .../build-example-xmk-native_posix_64.yml | 2 +- .github/workflows/build-example-xmk-xmk.yml | 2 +- readme.org | 26 ++++++++++++------- 5 files changed, 22 insertions(+), 14 deletions(-) diff --git a/.github/workflows/build-example-mousekeyspr.yml b/.github/workflows/build-example-mousekeyspr.yml index e26830e..b748d6d 100644 --- a/.github/workflows/build-example-mousekeyspr.yml +++ b/.github/workflows/build-example-mousekeyspr.yml @@ -1,4 +1,4 @@ -# Copyright 2023 Manna Harbour +# Copyright 2024 Manna Harbour # https://github.com/manna-harbour/miryoku name: 'Build Example mousekeyspr' @@ -11,4 +11,4 @@ jobs: board: '["nice_nano"]' shield: '["corne_left"]' custom_config: '["#define MIRYOKU_KLUDGE_MOUSEKEYSPR"]' - branches: '["zmkfirmware/zmk/main caksoylar/zmk/feat/mouse-keys-3.2"]' + branches: '["caksoylar/zmk/feat/mouse-keys-3.2","zmkfirmware/zmk/main caksoylar/zmk/feat/mouse-keys-3.2"]' diff --git a/.github/workflows/build-example-suspend.yml b/.github/workflows/build-example-suspend.yml index e8420f4..ad114a5 100644 --- a/.github/workflows/build-example-suspend.yml +++ b/.github/workflows/build-example-suspend.yml @@ -11,4 +11,4 @@ jobs: board: '["nice_nano"]' shield: '["corne_left","corne_right"]' custom_config: '["#define MIRYOKU_KLUDGE_SUSPEND"]' - branches: '["zmkfirmware/zmk/main manna-harbour/zmk/suspend-test"]' + branches: '["manna-harbour/zmk/suspend-test","zmkfirmware/zmk/main manna-harbour/zmk/suspend-test"]' diff --git a/.github/workflows/build-example-xmk-native_posix_64.yml b/.github/workflows/build-example-xmk-native_posix_64.yml index 5afad2a..9cf8c44 100644 --- a/.github/workflows/build-example-xmk-native_posix_64.yml +++ b/.github/workflows/build-example-xmk-native_posix_64.yml @@ -10,4 +10,4 @@ jobs: with: board: '["native_posix_64"]' custom_config: '["#define MIRYOKU_KLUDGE_TAPDELAY"]' - branches: '["zmkfirmware/zmk/main petejohanson/zmk/shell/tap-command"]' + branches: '["petejohanson/zmk/shell/tap-command","zmkfirmware/zmk/main petejohanson/zmk/shell/tap-command"]' diff --git a/.github/workflows/build-example-xmk-xmk.yml b/.github/workflows/build-example-xmk-xmk.yml index 4910810..83c4f04 100644 --- a/.github/workflows/build-example-xmk-xmk.yml +++ b/.github/workflows/build-example-xmk-xmk.yml @@ -10,4 +10,4 @@ jobs: with: board: '["nice_nano_v2"]' shield: '["xmk"]' - branches: '["zmkfirmware/zmk/main petejohanson/zmk/shell/tap-command"]' + branches: '["petejohanson/zmk/shell/tap-command","zmkfirmware/zmk/main petejohanson/zmk/shell/tap-command"]' diff --git a/readme.org b/readme.org index 376f9ad..aa34bb3 100644 --- a/readme.org +++ b/readme.org @@ -171,7 +171,7 @@ Used to select an alternative ZMK branch for building, and to merge branches int Branches are specified in the form ~//~. E.g. the default ZMK branch would be specified as ~zmkfirmware/zmk/main~. -Multiple space separated branches can be specified. The first branch specified is used as an alternative ZMK branch for building. Any additional branches will be merged. +Multiple space separated branches can be specified. The first branch specified is used as an alternative ZMK branch for building. Any additional branches will be merged. Automatic merging is only possible where there are no conflicts. If there are conflicts, build from the branch directly, or request a rebase from the branch maintainer. For no changes, leave as ~default~. @@ -490,9 +490,11 @@ Mouse movement requires [[https://en.wikipedia.org/wiki/Mouse_keys][enabling mou Mouse movement and scroll is supported with https://github.com/caksoylar/zmk/tree/feat/mouse-keys-3.2. -To build, add ~#define MIRYOKU_KLUDGE_MOUSEKEYSPR~ to the [[#config-file][config file]], and merge the mousekeys branch. +To build, add ~#define MIRYOKU_KLUDGE_MOUSEKEYSPR~ to the [[#config-file][config file]], and switch to or merge the mousekeys branch. -For [[#workflow-builds][workflow builds]] using the [[#build-inputs][Build Inputs]] workflow, use ~#define MIRYOKU_KLUDGE_MOUSEKEYSPR~ with the ~custom_config~ option, and ~zmkfirmware/zmk/main caksoylar/zmk/feat/mouse-keys-3.2~ with the ~branches~ option. For workflow builds using [[#build-examples][Build Example]] workflows, see the [[.github/workflows/build-example-mousekeyspr.yml][Build Example mousekeyspr]] workflow. +For [[#workflow-builds][workflow builds]] using the [[#build-inputs][Build Inputs]] workflow, use ~#define MIRYOKU_KLUDGE_MOUSEKEYSPR~ with the ~custom_config~ option, and ~caksoylar/zmk/feat/mouse-keys-3.2~ with the ~branches~ option. Alternatively, use ~zmkfirmware/zmk/main caksoylar/zmk/feat/mouse-keys-3.2~ to attempt an automatic [[#branches][merge]] of the branch into ZMK main. + +For workflow builds using [[#build-examples][Build Example]] workflows, see the [[.github/workflows/build-example-mousekeyspr.yml][Build Example mousekeyspr]] workflow. For local builds, make the changes locally. @@ -503,9 +505,11 @@ Support for https://github.com/zmkfirmware/zmk/issues/1292#issuecomment-12646035 Suspend takes the place of the [[https://github.com/manna-harbour/miryoku/tree/master/docs/reference#additional-features][boot]] key. For split keyboards, suspend the peripheral side then the central side. -For [[#local-builds][local builds]], add ~#define MIRYOKU_KLUDGE_SUSPEND~ to the [[#config-file][config file]] and merge https://github.com/manna-harbour/zmk/tree/suspend-test. +For [[#local-builds][local builds]], add ~#define MIRYOKU_KLUDGE_SUSPEND~ to the [[#config-file][config file]] and switch to or merge https://github.com/manna-harbour/zmk/tree/suspend-test. -For [[#workflow-builds][workflow builds]] using the [[#build-inputs][Build Inputs]] workflow, use ~#define MIRYOKU_KLUDGE_SUSPEND~ with the ~custom_config~ option, and ~zmkfirmware/zmk/main manna-harbour/zmk/suspend-test~ with the ~branches~ option. For workflow builds using [[#build-examples][Build Example]] workflows, see the [[.github/workflows/build-example-suspend.yml][Build Example suspend]] workflow. +For [[#workflow-builds][workflow builds]] using the [[#build-inputs][Build Inputs]] workflow, use ~#define MIRYOKU_KLUDGE_SUSPEND~ with the ~custom_config~ option, and ~manna-harbour/zmk/suspend-test~ with the ~branches~ option. Alternatively, use ~zmkfirmware/zmk/main manna-harbour/zmk/suspend-test~ to attempt an automatic [[#branches][merge]] of the branch into ZMK main. + +For workflow builds using [[#build-examples][Build Example]] workflows, see the [[.github/workflows/build-example-suspend.yml][Build Example suspend]] workflow. *** Tap Delay @@ -522,16 +526,20 @@ Use Miryoku ZMK with any keyboard with [[https://github.com/manna-harbour/xmk][ **** xmk Shield -For [[#local-builds][local builds]] first merge https://github.com/zmkfirmware/zmk/pull/1318. Add https://github.com/manna-harbour/xmk/tree/main/zmk/boards/shields/xmk as ~config/boards/shields/xmk~. Build with shield ~xmk~ and the appropriate board. +For [[#local-builds][local builds]], first switch to or merge https://github.com/zmkfirmware/zmk/pull/1318. Add https://github.com/manna-harbour/xmk/tree/main/zmk/boards/shields/xmk as ~config/boards/shields/xmk~. Build with shield ~xmk~ and the appropriate board. -For [[#workflow-builds][workflow builds]] using the [[#build-inputs][Build Inputs]] workflow, use ~xmk~ with the ~shield~ option, the appropriate board with the ~board~ option, and ~zmkfirmware/zmk/main petejohanson/zmk/shell/tap-command~ with the ~branches~ option. For workflow builds using [[#build-examples][Build Example]] workflows, see the [[.github/workflows/build-example-xmk-xmk.yml][Build Example 𝑥MK xmk]] workflow. +For [[#workflow-builds][workflow builds]] using the [[#build-inputs][Build Inputs]] workflow, use ~xmk~ with the ~shield~ option, the appropriate board with the ~board~ option, and ~petejohanson/zmk/shell/tap-command~ with the ~branches~ option. Alternatively, use ~zmkfirmware/zmk/main petejohanson/zmk/shell/tap-command~ to attempt an automatic [[#branches][merge]] of the branch into ZMK main. + +For workflow builds using [[#build-examples][Build Example]] workflows, see the [[.github/workflows/build-example-xmk-xmk.yml][Build Example 𝑥MK xmk]] workflow. **** native_posix_64 Board -For [[#local-builds][local builds]] first merge https://github.com/zmkfirmware/zmk/pull/1318. Add ~#define MIRYOKU_KLUDGE_TAPDELAY~ to the config file. Build with board ~native_posix_64~. +For [[#local-builds][local builds]], first switch to or merge https://github.com/zmkfirmware/zmk/pull/1318. Add ~#define MIRYOKU_KLUDGE_TAPDELAY~ to the config file. Build with board ~native_posix_64~. -For [[#workflow-builds][workflow builds]] using the [[#build-inputs][Build Inputs]] workflow, use ~native_posix_64~ with the ~board~ option, ~#define MIRYOKU_KLUDGE_TAPDELAY~ with the ~custom_config~ option, and ~zmkfirmware/zmk/main petejohanson/zmk/shell/tap-command~ with the ~branches~ option. For workflow builds using [[#build-examples][Build Example]] workflows, see the [[.github/workflows/build-example-xmk-native_posix_64.yml][Build Example 𝑥MK native_posix_64]] workflow. +For [[#workflow-builds][workflow builds]] using the [[#build-inputs][Build Inputs]] workflow, use ~native_posix_64~ with the ~board~ option, ~#define MIRYOKU_KLUDGE_TAPDELAY~ with the ~custom_config~ option, and ~petejohanson/zmk/shell/tap-command~ with the ~branches~ option. Alternatively, use ~zmkfirmware/zmk/main petejohanson/zmk/shell/tap-command~ to attempt an automatic [[#branches][merge]] of the branch into ZMK main. + +For workflow builds using [[#build-examples][Build Example]] workflows, see the [[.github/workflows/build-example-xmk-native_posix_64.yml][Build Example 𝑥MK native_posix_64]] workflow. ** Issues