Merge carousel2.love

README.md

···
 * `ctrl+z` to undo, `ctrl+y` to redo
 * `ctrl+=` to zoom in, `ctrl+-` to zoom out, `ctrl+0` to reset zoom
 * `alt+right`/`alt+left` to jump to the next/previous word, respectively
+  Only left alt is supported, because many keyboard layouts use right alt like
+  shift for typing characters, and I don't know how to figure out the current
+  layout.
 * mouse drag or `shift` + movement to select text, `ctrl+a` to select all
 
 Exclusively tested so far with a US keyboard layout. If

edit.lua

···
     return
   end
   if move.to_coord(editor, editor.cursor) == nil then return end  -- cursor is off screen
-  if keychord.any_modifier_down() and key_down(t) then
-    -- The modifiers didn't change the key. Handle it in keychord_press.
+  -- textinput events can occur on chords with the shift key or AltGr key
+  -- but not for ctrl, alt or cmd/super/gui
+  if keychord.ctrl_down() or keychord.alt_down() or keychord.cmd_down() then
     return
   end
   if not readonly then

keychord.lua

···
   end
 end
 
-function keychord.any_modifier_down()
-  return keychord.ctrl_down() or keychord.alt_down() or keychord.shift_down() or keychord.cmd_down()
+-- Many keyboard layouts use a special altGr key to insert additional
+-- printable characters. SDL/LÖVE can't represent altGr distinctly.
+function I.alt_gr_down()
+  return key_down('ralt')
 end
 
+-- altGr is a separate modifier and never considered with alt or ctrl,
+-- regardless of layout.
 function keychord.ctrl_down()
+  if I.alt_gr_down() then return false end
   return key_down('lctrl') or key_down('rctrl')
 end
 
 function keychord.alt_down()
+  if I.alt_gr_down() then return false end
   return key_down('lalt') or key_down('ralt')
 end
 

reference.md

···
   Provides in `chord` a string representation of the current key combination,
   consisting of the key with the following prefixes:
     * `C-` if one of the `ctrl` keys is pressed,
-    * `M-` if one of the `alt` keys is pressed,
+    * `M-` if the left `alt` key is pressed (right alt has other meanings in
+      some keyboard layouts, so we never check for it),
     * `S-` if one of the `shift` keys is pressed, and
     * `s-` if the `windows`/`cmd`/`super` key is pressed.