From 70f5d18fe9d5d15b95053d6cf54d3359377655c2 Mon Sep 17 00:00:00 2001 From: Leena Miettinen Date: Thu, 3 Aug 2023 16:59:43 +0200 Subject: [PATCH] Doc: Turn Opening Projects into a How-to topic Describe the ways to open projects before the case where one needs to re-configure the project. Task-number: QTCREATORBUG-29361 Change-Id: I32b8676112e412fe8b4f114c54371169f478d361 Reviewed-by: Eike Ziller --- .../qtcreator-welcome-open-projects.webp | Bin 0 -> 17760 bytes .../cmake/creator-projects-cmake-presets.qdoc | 2 +- .../src/cmake/creator-projects-cmake.qdoc | 4 +- .../creator-only/creator-clang-codemodel.qdoc | 2 +- .../howto/creator-only/creator-how-tos.qdoc | 1 + .../src/meson/creator-projects-meson.qdoc | 2 +- .../creator-projects-creating.qdoc | 5 +- .../creator-projects-libraries.qdoc | 2 +- .../creator-projects-opening.qdoc | 128 ++++++++++-------- .../creator-only/creator-projects-qbs.qdoc | 2 +- .../creator-projects-settings-overview.qdoc | 2 +- doc/qtcreator/src/qtcreator-toc.qdoc | 2 +- 12 files changed, 82 insertions(+), 70 deletions(-) create mode 100644 doc/qtcreator/images/qtcreator-welcome-open-projects.webp diff --git a/doc/qtcreator/images/qtcreator-welcome-open-projects.webp b/doc/qtcreator/images/qtcreator-welcome-open-projects.webp new file mode 100644 index 0000000000000000000000000000000000000000..5281669b40716639989f69d26b7931e0c3f3f26e GIT binary patch literal 17760 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 \uicontrol {Open File or Project}. + \li In the \uicontrol Welcome mode, \uicontrol Projects tab, select + \uicontrol {Open Project} (1). + \image qtcreator-welcome-open-projects.webp {Ways to open projects in the Welcome mode Projects tab} + \li In the \uicontrol Projects tab, select a project in the list of + recently opened projects (2). + \li In the \l Projects view, right-click to open a context + menu and select \uicontrol {Load Project} to open the + \uicontrol {Load Project} dialog, where you can select + a project file. + \li Use the following keyboard shortcuts, depending on the mode you are + currently in: + \list + \li In all modes, press \key Ctrl+O (\key Cmd+O on \macos) to open the + \uicontrol {Open File} dialog, where you can select a project file. + \li On Windows and Linux, in all modes except the \uicontrol Help mode, + press \key Ctrl+Shift+O to open the \uicontrol {Load Project} dialog. + \li In the \uicontrol Welcome mode, \uicontrol Projects tab, press + \key Ctrl+Shift+number (\key Cmd+Shift+number on \macos), where + the number is the number of a project in the list of recently opened + projects (3). + \endlist + \endlist + + \section1 Re-configure projects \QC stores information that it needs to build projects in a .user file. If \QC cannot find the file when you open an existing project, it prompts you - to enter the information. If you used another \QC instance to create the - project, \QC asks whether you want to use the old settings. The settings - are specific to the development environment, and you should not copy them from - one environment to another. Therefore, we recommend that you select \uicontrol No - and enter the information again in the \uicontrol {Configure Project} tab. + to enter the information. - The \uicontrol {Configure Project} tab displays a list of \l{glossary-buildandrun-kit}{kits} - for building and running projects, that you install on the development PC and - configure in \uicontrol Edit > \uicontrol Preferences > \uicontrol Kits. - Select the kits that you want to build and run the project with. + If you used another \QC instance to create the project, \QC asks whether you + want to use the old settings. The settings are specific to the development + environment, and you should not copy them from one environment to another. + Therefore, we recommend that you select \uicontrol No and enter the + information again in the \uicontrol {Configure Project} tab. - \image qtcreator-open-project-kits.png "Configure Project tab" + To re-configure projects: + + \list 1 + \li In the \uicontrol {Configure Project} tab, select + \l{glossary-buildandrun-kit}{kits} for building + and running your project. + \image qtcreator-open-project-kits.png {Configure Project tab} + \li Select \uicontrol {Configure Project}. + \endlist + + The \uicontrol {Configure Project} tab displays a list of kits that you + install on the development PC and configure in \uicontrol Edit > + \uicontrol Preferences > \uicontrol Kits. Even if you do not intend to build the project, the C++ and QML code models need a Qt version and compiler to offer code completion. To specify them, @@ -39,61 +83,27 @@ {language server client} for code completion, highlighting, and other useful features. - If \QC cannot find an existing build for a particular \l{glossary-buildandrun-kit}{kit}, - it starts out - from a clean slate, and creates new debug and release build configurations - in the specified directory. \QC suggests a name - and location for the directory that you can change. + If \QC cannot find an existing build for a particular kit, it starts out + from a clean slate and creates new debug and release build configurations + in the specified directory. \QC suggests a name and location for the + directory that you can change. + + \section1 Import builds If you have built the project before, \QC can use the existing build configuration to make the exact same build available to you. To import a - build, specify a directory in the - \uicontrol {Import Build From} section and select \uicontrol {Import}. + build, specify a directory in the \uicontrol {Import Build From} section + of the \uicontrol {Configure Project} tab and select \uicontrol {Import}. You can edit the build configuration later. For more information, see \l{Editing Build Configurations}. - To open a project: - - \list 1 - - \li Select \uicontrol File > \uicontrol {Open File or Project} - (\key Ctrl+O or \key Cmd+O on \macos) and select the project file - for the project to open: \e {.pro} (qmake), \e {CMakeLists.txt} - (CMake), \e {.qbs} (Qbs), \e {meson.build} (Meson), \e {pyproject} (Python), or - \e {Makefile.am} (Autotools, experimental). - - \li In the \uicontrol {Configure Project} tab, select kits for building - and running your project. - - \li Select \uicontrol {Configure Project}. - - \endlist - - You can use the following keyboard shortcuts to open projects, depending on - the mode you are currently in: - - \list - - \li In all modes, press \key Ctrl+O (\key Cmd+O on \macos) to open the - \uicontrol {Open File} dialog, where you can select a project file - to open a project. - - \li In all modes, except the \uicontrol Help mode, press - \key Ctrl+Shift+O (\key Cmd+Shift+O on \macos) to open the - \uicontrol {Load Project} dialog, where you can select a project - file to open a project. - - \li In the \uicontrol Welcome mode, \uicontrol Projects tab, press - \key Ctrl+Shift+number (\key Cmd+Shift+number on \macos), where - the number is the number of a project in the list of recently opened - projects. - - \endlist + \section1 Show progress information \QC parses all the source files in the project and performs a semantic analysis to build up the information that it needs for functions such as navigation and finding usages. A progress bar is displayed during parsing. + To show or hide detailed progress information, select \uicontrol {Toggle Progress Details} (1). @@ -102,4 +112,6 @@ You can drag the progress bar to another position. The position is saved for later. Select the \inlineimage icons/pin.png (\uicontrol Pin) button to pin the progress bar back to the toggle button. + + \sa {Adding Kits} */ diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-qbs.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-qbs.qdoc index 9d7504b85af..22bafa78bb7 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-qbs.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-qbs.qdoc @@ -66,7 +66,7 @@ \section1 Related Topics \list - \li \l {Opening Projects} + \li \l {Open projects} \li \l {Qbs Build Configuration} \li \l {Specifying Run Settings} \endlist diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc index fff52cf5707..926e1596e3b 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc @@ -20,7 +20,7 @@ targets. Select the kits to use in the \uicontrol {Configure Projects} view when you open a project for the first time. At least one kit must be active. For more information about selecting the initial kit, see - \l{Opening Projects}. + \l{Open projects}. To maintain the list of active kits for a currently open project, switch to the \uicontrol Projects mode by pressing \key Ctrl+5. diff --git a/doc/qtcreator/src/qtcreator-toc.qdoc b/doc/qtcreator/src/qtcreator-toc.qdoc index 08e8ee82128..7d71c101e51 100644 --- a/doc/qtcreator/src/qtcreator-toc.qdoc +++ b/doc/qtcreator/src/qtcreator-toc.qdoc @@ -25,7 +25,6 @@ \list \li \l{Creating Projects} \list - \li \l{Opening Projects} \li \l{Adding Libraries to Projects} \li \l{Adding New Custom Wizards} \endlist @@ -282,6 +281,7 @@ \li \l {Create OpenGL fragment and vertex shaders} \li \l {Create resource files} \li \l {Develop Qt for Python applications} + \li \l {Open projects} \li \l {Select the build system} \li \l {Specify project contents} \li \l {Use project wizards}