From afac0965c2b48efcefec327c798007cb2399ec8a Mon Sep 17 00:00:00 2001 From: Leena Miettinen Date: Thu, 10 Oct 2024 15:24:54 +0200 Subject: [PATCH] Doc: Edit info about configuring external tools The menu items in Tools > External are meant as examples. To use the system editor, it is better to use Open With > System Editor. Change-Id: Ib746846e6bfff29f4884a9d4ab6363d9831dfb04 Reviewed-by: Eike Ziller --- .../src/howto/creator-external-tools.qdoc | 35 ++++++++++++++----- 1 file changed, 26 insertions(+), 9 deletions(-) diff --git a/doc/qtcreator/src/howto/creator-external-tools.qdoc b/doc/qtcreator/src/howto/creator-external-tools.qdoc index 54f457cb7ca..155b40be0f5 100644 --- a/doc/qtcreator/src/howto/creator-external-tools.qdoc +++ b/doc/qtcreator/src/howto/creator-external-tools.qdoc @@ -20,9 +20,10 @@ \title Use external tools - You can use external tools directly from \QC. You can change the default - configurations of the QML preview tools and the default text editor for - your system or configure new tools. + You can add menu items for using external tools directly from \QC to + \uicontrol Tools > \uicontrol External. As examples, the menu shows + items for opening the currently active file for editing in a text editor + or running the currently active QML file. To run the tools, select \uicontrol Tools > \uicontrol External, or use the \c x filter in the locator. @@ -41,6 +42,7 @@ particular context. \endif + To configure external tools: \list 1 @@ -197,12 +199,27 @@ \title Use external text editors - You can open files for editing in the default text editor for your system: - Notepad on Windows and vi on Linux and \macos. - To open the file you are currently viewing in an external editor, select - \uicontrol Tools > \uicontrol External > \uicontrol Text > - \uicontrol {Edit with Notepad} or \uicontrol {Edit with vi}, depending on - your system. + To open files for editing in the default text editor for your system: + + \list 1 + \li Right-click the filename in one of the following views to open a context + menu: + \list + \li \l {Edit mode} + \li \l {File System} + \li \l {Open Documents} + \li \l {Projects} + \endlist + \li Select \uicontrol {Open With} > \uicontrol {System Editor}. + \endlist + + \section1 Add editors to Tools menu + + You can add menu items for opening the file you are currently viewing in + an external editor to \uicontrol Tools > \uicontrol External > + \uicontrol Text. The current example commands are + \uicontrol {Edit with Notepad} on Windows and \uicontrol {Edit with vi} on + Linux and \macos. \QC looks for the editor path in the PATH environment variable of your operating system.