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

more accurately describe editor behavior

Browse Source
This commit is contained in:
egnor 2021-07-28 23:41:47 -07:00
parent a1fc383e6f
commit 0d55865545
3 changed files with 21 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/glossary.rst
View File

@ -52,6 +52,16 @@ Variables that influence kitty behavior
files. Defaults to :file:`~/.config/kitty`. For full details of the config files. Defaults to :file:`~/.config/kitty`. For full details of the config
directory lookup mechanism see, :option:`kitty --config`. directory lookup mechanism see, :option:`kitty --config`.
.. envvar:: EDITOR
The terminal editor (such as `vi` or `nano`) for editing config files.
Overridden by :envvar:`VISUAL`.
.. envvar:: VISUAL
The terminal editor (such as `vi` or `nano`) for editing config files.
Takes precedence over :envvar:`EDITOR`.
.. envvar:: VISUAL .. envvar:: VISUAL

7
docs/kittens/remote_file.rst
View File

@ -17,9 +17,10 @@ Then hold down :kbd:`ctrl+shift` and click the name of the file.
|kitty| will ask you what you want to do with the remote file. You can choose |kitty| will ask you what you want to do with the remote file. You can choose
to *Edit* it in which case kitty will download it and open it locally in your to *Edit* it in which case kitty will download it and open it locally in your
``EDITOR``. As you make changes to the file, they are automatically transferred :envvar:`EDITOR`. As you make changes to the file, they are automatically
to the remote computer. Note that this happens without needing to install *any* transferred to the remote computer. Note that this happens without needing
special software on the server, beyond ``ls`` that supports hyperlinks. to install *any* special software on the server, beyond ``ls`` that supports
hyperlinks.
.. versionadded:: 0.19.0 .. versionadded:: 0.19.0

14
kitty/options/definition.py
View File

@ -2418,13 +2418,13 @@ starts in interactive mode and reads its startup rc files.
opt('editor', '.', opt('editor', '.',
long_text=''' long_text='''
The console editor to use when editing the kitty config file or similar tasks. The console editor to use when editing the kitty config file or similar tasks.
The default value of ``.`` means to use the environment variables :envvar:`VISUAL`
and :envvar:`EDITOR` in that order. Note that these environment variables have The default value of . means to use the environment variables :envvar:`VISUAL`
to be set when kitty starts, so if they're only set in shell startup scripts, but and :envvar:`EDITOR` in that order. If these variables aren't set, kitty will
kitty is launched directly from your desktop, kitty will not see them. kitty does try run your shell (`$SHELL -l -c env`) to see if your shell config files set
to read the values from the shell as well, but this process is not entirely robust since :envvar:`VISUAL` or :envvar:`EDITOR`. If that doesn't work, kitty will cycle
there are a myriad different shells out there. In that case you're better off naming through various known editors (`vim`, `emacs`, etc) and take the first one
your favorite editor here. that exists on your system.
''' '''
) )