summaryrefslogtreecommitdiffstats
path: root/doc/classes/EditorSettings.xml
diff options
context:
space:
mode:
authorYuri Sizov <yuris@humnom.net>2023-12-22 17:19:53 +0100
committerYuri Sizov <yuris@humnom.net>2023-12-22 17:19:53 +0100
commit13d34d6a2b80391a038f441729610af0b207250b (patch)
tree9b8c1e8c899736a04f989a555b1d551e710dd997 /doc/classes/EditorSettings.xml
parent6b403712f1adc5e2ba96682bb163a7bd378ceb81 (diff)
parent0e97acff84ca6c859b48b22a6d42c4680ef1c432 (diff)
downloadredot-engine-13d34d6a2b80391a038f441729610af0b207250b.tar.gz
Merge pull request #85923 from Calinou/editor-filesystem-dock-add-open-in-terminal
Add a editor FileSystem dock action to open a terminal in selected folder
Diffstat (limited to 'doc/classes/EditorSettings.xml')
-rw-r--r--doc/classes/EditorSettings.xml15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/classes/EditorSettings.xml b/doc/classes/EditorSettings.xml
index 93d2bb8548..5c317a5088 100644
--- a/doc/classes/EditorSettings.xml
+++ b/doc/classes/EditorSettings.xml
@@ -466,6 +466,21 @@
<member name="filesystem/external_programs/raster_image_editor" type="String" setter="" getter="">
The program that opens raster image files when clicking "Open in External Program" option in Filesystem Dock. If not specified, the file will be opened in the system's default program.
</member>
+ <member name="filesystem/external_programs/terminal_emulator" type="String" setter="" getter="">
+ The terminal emulator program to use when using [b]Open in Terminal[/b] context menu action in the FileSystem dock. You can enter an absolute path to a program binary, or a path to a program that is present in the [code]PATH[/code] environment variable.
+ If left empty, Godot will use the default terminal emulator for the system:
+ - [b]Windows:[/b] PowerShell
+ - [b]macOS:[/b] Terminal.app
+ - [b]Linux:[/b] The first terminal found on the system in this order: gnome-terminal, konsole, xfce4-terminal, lxterminal, kitty, alacritty, urxvt, xterm.
+ To use Command Prompt (cmd) instead of PowerShell on Windows, enter [code]cmd[/code] in this field and the correct flags will automatically be used.
+ On macOS, make sure to point to the actual program binary located within the [code]Programs/MacOS[/code] folder of the .app bundle, rather than the .app bundle directory.
+ If specifying a custom terminal emulator, you may need to override [member filesystem/external_programs/terminal_emulator_flags] so it opens in the correct folder.
+ </member>
+ <member name="filesystem/external_programs/terminal_emulator_flags" type="String" setter="" getter="">
+ The command-line arguments to pass to the terminal emulator that is run when using [b]Open in Terminal[/b] context menu action in the FileSystem dock. See also [member filesystem/external_programs/terminal_emulator].
+ If left empty, the default flags are [code]{directory}[/code], which is replaced by the absolute path to the directory that is being opened in the terminal.
+ [b]Note:[/b] If the terminal emulator is set to PowerShell, cmd, or Konsole, Godot will automatically prepend arguments to this list, as these terminals require nonstandard arguments to open in the correct folder.
+ </member>
<member name="filesystem/external_programs/vector_image_editor" type="String" setter="" getter="">
The program that opens vector image files when clicking "Open in External Program" option in Filesystem Dock. If not specified, the file will be opened in the system's default program.
</member>