Merge branch 'master-macos_option_as_alt_docs' of https://github.com/miguno/kitty

This commit is contained in:
Kovid Goyal 2022-04-01 18:27:14 +05:30
commit 3257fdf24f
No known key found for this signature in database
GPG Key ID: 06BC317B515ACE7C

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.
''' '''
) )