KittyPatch/kitty
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Clarify documentation of macos_option_as_alt

Browse Source 
See discussion at https://github.com/kovidgoyal/kitty/issues/4908
This commit is contained in:
Michael G. Noll 2022-04-01 14:52:12 +02:00
parent cdb3e2c1cd
commit 3284d71300
1 changed files with 11 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
kitty/options/definition.py
View File

@ -2820,12 +2820,17 @@ just hiding the titlebar with :opt:`hide_window_decorations`.
opt('macos_option_as_alt', 'no', opt('macos_option_as_alt', 'no',
option_type='macos_option_as_alt', ctype='uint', option_type='macos_option_as_alt', ctype='uint',
long_text=''' long_text='''
Use the option key as an alt key. With this set to :code:`no`, kitty will use Use the :kbd:`Option` key as an :kbd:`Alt` key. With this set to :code:`no`,
the macOS native :kbd:`Option+Key` = unicode character behavior. This will break kitty will use the macOS native :kbd:`Option+Key` = unicode character behavior.
any :kbd:`Alt+key` keyboard shortcuts in your terminal programs, but you can use This will break any :kbd:`Alt+Key` keyboard shortcuts in your terminal programs,
the macOS unicode input technique. You can use the values: :code:`left`, but you can use the macOS unicode input technique. You can use the values:
:code:`right`, or :code:`both` to use only the left, right or both Option keys :code:`left`, :code:`right`, or :code:`both` to use only the left, right or both
as Alt, instead. Changing this setting by reloading the config is not supported. :kbd:`Option` keys as :kbd:`Alt`, instead. Note that kitty itself always treats
:kbd:`Option` the same as :kbd:`Alt`. This means you cannot use this setting to
configure different kitty shortcuts for :kbd:`Option+Key` vs. `:kbd:`Alt+Key`.
Also, any kitty shortcuts using :kbd:`Option/Alt+Key` will take priority, so
that any such key presses will not be passed to terminal programs running inside
kitty. Changing this setting by reloading the config is not supported.
''' '''
) )