Doc cleanup: remove old gettingStarted tutorial, move doc file

The Qt getting started tutorial is based on the "notepad" example files
in this directory, the gettingStarted/gsQt files are completely unused
and not referenced in documentation.

Change-Id: If8caebd2c8359c81f94f72ef40a1cf92a021a83f
Reviewed-by: Safiyyah Moosa <safiyyah.moosa@qt.io>
Reviewed-by: Axel Spoerl <axel.spoerl@qt.io>
(cherry picked from commit c6540cb6e41aea6b4152109cade9aa145884a8f6)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>

examples/widgets/tutorials/CMakeLists.txt

@@ -3,5 +3,4 @@
 
 add_subdirectory(widgets)
 add_subdirectory(modelview)
-add_subdirectory(gettingStarted)
 qt_internal_add_example(notepad)

examples/widgets/tutorials/gettingStarted/CMakeLists.txt

@@ -1 +0,0 @@
-add_subdirectory(gsQt)

examples/widgets/tutorials/gettingStarted/gettingStarted.pro

@@ -1,4 +0,0 @@
-TEMPLATE = subdirs
-SUBDIRS += dir_gsqt
-
-dir_gsqt.file = gsQt/gsqt.pro

examples/widgets/tutorials/gettingStarted/gsQt/CMakeLists.txt

@@ -1,8 +0,0 @@
-# Copyright (C) 2022 The Qt Company Ltd.
-# SPDX-License-Identifier: BSD-3-Clause
-
-qt_internal_add_example(part1)
-qt_internal_add_example(part2)
-qt_internal_add_example(part3)
-qt_internal_add_example(part4)
-qt_internal_add_example(part5)

examples/widgets/tutorials/gettingStarted/gsQt/gsqt.pro

@@ -1,7 +0,0 @@
-TEMPLATE = subdirs
-
-SUBDIRS = part1 \
-          part2 \
-          part3 \
-          part4 \
-          part5

examples/widgets/tutorials/gettingStarted/gsQt/part1/CMakeLists.txt

@@ -1,36 +0,0 @@
-# Copyright (C) 2022 The Qt Company Ltd.
-# SPDX-License-Identifier: BSD-3-Clause
-
-cmake_minimum_required(VERSION 3.16)
-project(getting_started_part1 LANGUAGES CXX)
-
-if(NOT DEFINED INSTALL_EXAMPLESDIR)
-    set(INSTALL_EXAMPLESDIR "examples")
-endif()
-
-set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/widgets/tutorials/gettingStarted/gsQt/part1")
-
-find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets)
-
-qt_standard_project_setup()
-
-qt_add_executable(getting_started_part1
-    main.cpp
-)
-
-set_target_properties(getting_started_part1 PROPERTIES
-    WIN32_EXECUTABLE TRUE
-    MACOSX_BUNDLE TRUE
-)
-
-target_link_libraries(getting_started_part1 PRIVATE
-    Qt6::Core
-    Qt6::Gui
-    Qt6::Widgets
-)
-
-install(TARGETS getting_started_part1
-    RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}"
-    BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}"
-    LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}"
-)

examples/widgets/tutorials/gettingStarted/gsQt/part1/main.cpp

@@ -1,15 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
-
-#include <QtWidgets>
-
-int main(int argc, char *argv[])
-{
-    QApplication app(argc, argv);
-
-    QTextEdit textEdit;
-    textEdit.show();
-
-    return app.exec();
-}
-

examples/widgets/tutorials/gettingStarted/gsQt/part1/part1.pro

@@ -1,8 +0,0 @@
-
-QT += widgets
-SOURCES = main.cpp
-
-# install
-target.path = $$[QT_INSTALL_EXAMPLES]/widgets/tutorials/gettingStarted/gsQt/part1
-INSTALLS += target
-

examples/widgets/tutorials/gettingStarted/gsQt/part2/CMakeLists.txt

@@ -1,36 +0,0 @@
-# Copyright (C) 2022 The Qt Company Ltd.
-# SPDX-License-Identifier: BSD-3-Clause
-
-cmake_minimum_required(VERSION 3.16)
-project(getting_started_part2 LANGUAGES CXX)
-
-if(NOT DEFINED INSTALL_EXAMPLESDIR)
-    set(INSTALL_EXAMPLESDIR "examples")
-endif()
-
-set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/widgets/tutorials/gettingStarted/gsQt/part2")
-
-find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets)
-
-qt_standard_project_setup()
-
-qt_add_executable(getting_started_part2
-    main.cpp
-)
-
-set_target_properties(getting_started_part2 PROPERTIES
-    WIN32_EXECUTABLE TRUE
-    MACOSX_BUNDLE TRUE
-)
-
-target_link_libraries(getting_started_part2 PRIVATE
-    Qt6::Core
-    Qt6::Gui
-    Qt6::Widgets
-)
-
-install(TARGETS getting_started_part2
-    RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}"
-    BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}"
-    LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}"
-)

examples/widgets/tutorials/gettingStarted/gsQt/part2/main.cpp

@@ -1,27 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
-
-#include <QtWidgets>
-
-int main(int argc, char *argv[])
-{
-    QApplication app(argc, argv);
-
-    QTextEdit *textEdit = new QTextEdit;
-    QPushButton *quitButton = new QPushButton("&Quit");
-
-    QObject::connect(quitButton, &QPushButton::clicked,
-                     qApp, &QApplication::quit);
-
-    QVBoxLayout *layout = new QVBoxLayout;
-    layout->addWidget(textEdit);
-    layout->addWidget(quitButton);
-
-    QWidget window;
-    window.setLayout(layout);
-
-    window.show();
-
-    return app.exec();
-}
-

examples/widgets/tutorials/gettingStarted/gsQt/part2/part2.pro

@@ -1,8 +0,0 @@
-
-QT += widgets
-SOURCES = main.cpp
-
-# install
-target.path = $$[QT_INSTALL_EXAMPLES]/widgets/tutorials/gettingStarted/gsQt/part2
-INSTALLS += target
-

examples/widgets/tutorials/gettingStarted/gsQt/part3/CMakeLists.txt

@@ -1,36 +0,0 @@
-# Copyright (C) 2022 The Qt Company Ltd.
-# SPDX-License-Identifier: BSD-3-Clause
-
-cmake_minimum_required(VERSION 3.16)
-project(getting_started_part3 LANGUAGES CXX)
-
-if(NOT DEFINED INSTALL_EXAMPLESDIR)
-    set(INSTALL_EXAMPLESDIR "examples")
-endif()
-
-set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/widgets/tutorials/gettingStarted/gsQt/part3")
-
-find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets)
-
-qt_standard_project_setup()
-
-qt_add_executable(getting_started_part3
-    main.cpp
-)
-
-set_target_properties(getting_started_part3 PROPERTIES
-    WIN32_EXECUTABLE TRUE
-    MACOSX_BUNDLE TRUE
-)
-
-target_link_libraries(getting_started_part3 PRIVATE
-    Qt6::Core
-    Qt6::Gui
-    Qt6::Widgets
-)
-
-install(TARGETS getting_started_part3
-    RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}"
-    BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}"
-    LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}"
-)

examples/widgets/tutorials/gettingStarted/gsQt/part3/main.cpp

@@ -1,61 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
-
-#include <QtWidgets>
-
-class Notepad : public QWidget
-{
-    Q_OBJECT
-
-public:
-    Notepad();
-
-private slots:
-    void quit();
-
-private:
-    QTextEdit *textEdit;
-    QPushButton *quitButton;
-
-};
-
-Notepad::Notepad()
-{
-    textEdit = new QTextEdit;
-    quitButton = new QPushButton(tr("Quit"));
-
-    connect(quitButton, &QPushButton::clicked,
-            this, &Notepad::quit);
-
-    QVBoxLayout *layout = new QVBoxLayout;
-    layout->addWidget(textEdit);
-    layout->addWidget(quitButton);
-
-    setLayout(layout);
-
-    setWindowTitle(tr("Notepad"));
-}
-
-void Notepad::quit()
-{
-    QMessageBox messageBox;
-    messageBox.setWindowTitle(tr("Notepad"));
-    messageBox.setText(tr("Do you really want to quit?"));
-    messageBox.setStandardButtons(QMessageBox::Yes | QMessageBox::No);
-    messageBox.setDefaultButton(QMessageBox::No);
-    if (messageBox.exec() == QMessageBox::Yes)
-        qApp->quit();
-}
-
-int main(int argc, char **argv)
-{
-    QApplication app(argc, argv);
-
-    Notepad notepad;
-    notepad.show();
-
-    return app.exec();
-}
-
-#include "main.moc"
-

examples/widgets/tutorials/gettingStarted/gsQt/part3/part3.pro

@@ -1,8 +0,0 @@
-
-QT += widgets
-SOURCES = main.cpp
-
-# install
-target.path = $$[QT_INSTALL_EXAMPLES]/widgets/tutorials/gettingStarted/gsQt/part3
-INSTALLS += target
-

examples/widgets/tutorials/gettingStarted/gsQt/part4/CMakeLists.txt

@@ -1,36 +0,0 @@
-# Copyright (C) 2022 The Qt Company Ltd.
-# SPDX-License-Identifier: BSD-3-Clause
-
-cmake_minimum_required(VERSION 3.16)
-project(getting_started_part4 LANGUAGES CXX)
-
-if(NOT DEFINED INSTALL_EXAMPLESDIR)
-    set(INSTALL_EXAMPLESDIR "examples")
-endif()
-
-set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/widgets/tutorials/gettingStarted/gsQt/part4")
-
-find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets)
-
-qt_standard_project_setup()
-
-qt_add_executable(getting_started_part4
-    main.cpp
-)
-
-set_target_properties(getting_started_part4 PROPERTIES
-    WIN32_EXECUTABLE TRUE
-    MACOSX_BUNDLE TRUE
-)
-
-target_link_libraries(getting_started_part4 PRIVATE
-    Qt6::Core
-    Qt6::Gui
-    Qt6::Widgets
-)
-
-install(TARGETS getting_started_part4
-    RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}"
-    BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}"
-    LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}"
-)

examples/widgets/tutorials/gettingStarted/gsQt/part4/main.cpp

@@ -1,73 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
-
-#include <QtWidgets>
-
-class Notepad : public QMainWindow
-{
-    Q_OBJECT
-
-public:
-    Notepad();
-
-private slots:
-    void load();
-    void save();
-
-private:
-    QTextEdit *textEdit;
-
-    QAction *loadAction;
-    QAction *saveAction;
-    QAction *exitAction;
-
-    QMenu *fileMenu;
-};
-
-Notepad::Notepad()
-{
-    loadAction = new QAction(tr("&Load"), this);
-    saveAction = new QAction(tr("&Save"), this);
-    exitAction = new QAction(tr("E&xit"), this);
-
-    connect(loadAction, &QAction::triggered,
-            this, &Notepad::load);
-    connect(saveAction, &QAction::triggered,
-            this, &Notepad::save);
-    connect(exitAction, &QAction::triggered,
-            qApp, &QApplication::quit);
-
-    fileMenu = menuBar()->addMenu(tr("&File"));
-    fileMenu->addAction(loadAction);
-    fileMenu->addAction(saveAction);
-    fileMenu->addSeparator();
-    fileMenu->addAction(exitAction);
-
-    textEdit = new QTextEdit;
-    setCentralWidget(textEdit);
-
-    setWindowTitle(tr("Notepad"));
-}
-
-void Notepad::load()
-{
-
-}
-
-void Notepad::save()
-{
-
-}
-
-int main(int argc, char **argv)
-{
-    QApplication app(argc, argv);
-
-    Notepad notepad;
-    notepad.show();
-
-    return app.exec();
-};
-
-#include "main.moc"
-

examples/widgets/tutorials/gettingStarted/gsQt/part4/part4.pro

@@ -1,8 +0,0 @@
-
-QT += widgets
-SOURCES = main.cpp
-
-# install
-target.path = $$[QT_INSTALL_EXAMPLES]/widgets/tutorials/gettingStarted/gsQt/part4
-INSTALLS += target
-

examples/widgets/tutorials/gettingStarted/gsQt/part5/CMakeLists.txt

@@ -1,36 +0,0 @@
-# Copyright (C) 2022 The Qt Company Ltd.
-# SPDX-License-Identifier: BSD-3-Clause
-
-cmake_minimum_required(VERSION 3.16)
-project(getting_started_part5 LANGUAGES CXX)
-
-if(NOT DEFINED INSTALL_EXAMPLESDIR)
-    set(INSTALL_EXAMPLESDIR "examples")
-endif()
-
-set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/widgets/tutorials/gettingStarted/gsQt/part5")
-
-find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets)
-
-qt_standard_project_setup()
-
-qt_add_executable(getting_started_part5
-    main.cpp
-)
-
-set_target_properties(getting_started_part5 PROPERTIES
-    WIN32_EXECUTABLE TRUE
-    MACOSX_BUNDLE TRUE
-)
-
-target_link_libraries(getting_started_part5 PRIVATE
-    Qt6::Core
-    Qt6::Gui
-    Qt6::Widgets
-)
-
-install(TARGETS getting_started_part5
-    RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}"
-    BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}"
-    LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}"
-)

examples/widgets/tutorials/gettingStarted/gsQt/part5/main.cpp

@@ -1,99 +0,0 @@
-// Copyright (C) 2016 The Qt Company Ltd.
-// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
-
-#include <QtWidgets>
-
-class Notepad : public QMainWindow
-{
-    Q_OBJECT
-
-public:
-    Notepad();
-
-private slots:
-    void open();
-    void save();
-
-private:
-    QTextEdit *textEdit;
-
-    QAction *openAction;
-    QAction *saveAction;
-    QAction *exitAction;
-
-    QMenu *fileMenu;
-};
-
-Notepad::Notepad()
-{
-    openAction = new QAction(tr("&Load"), this);
-    saveAction = new QAction(tr("&Save"), this);
-    exitAction = new QAction(tr("E&xit"), this);
-
-    connect(openAction, &QAction::triggered,
-            this, &Notepad::open);
-    connect(saveAction, &QAction::triggered,
-            this, &Notepad::save);
-    connect(exitAction, &QAction::triggered,
-            qApp, &QApplication::quit);
-
-    fileMenu = menuBar()->addMenu(tr("&File"));
-    fileMenu->addAction(openAction);
-    fileMenu->addAction(saveAction);
-    fileMenu->addSeparator();
-    fileMenu->addAction(exitAction);
-
-    textEdit = new QTextEdit;
-    setCentralWidget(textEdit);
-
-    setWindowTitle(tr("Notepad"));
-}
-
-void Notepad::open()
-{
-    QString fileName = QFileDialog::getOpenFileName(this, tr("Open File"), "",
-        tr("Text Files (*.txt);;C++ Files (*.cpp *.h)"));
-
-    if (!fileName.isEmpty()) {
-        QFile file(fileName);
-        if (!file.open(QIODevice::ReadOnly)) {
-            QMessageBox::critical(this, tr("Error"), tr("Could not open file"));
-            return;
-        }
-        QTextStream in(&file);
-        textEdit->setText(in.readAll());
-        file.close();
-    }
-}
-
-void Notepad::save()
-{
-
-    QString fileName = QFileDialog::getSaveFileName(this, tr("Save File"), "",
-        tr("Text Files (*.txt);;C++ Files (*.cpp *.h)"));
-
-    if (!fileName.isEmpty()) {
-        QFile file(fileName);
-        if (!file.open(QIODevice::WriteOnly)) {
-            // error message
-        } else {
-            QTextStream stream(&file);
-            stream << textEdit->toPlainText();
-            stream.flush();
-            file.close();
-        }
-    }
-}
-
-int main(int argc, char **argv)
-{
-    QApplication app(argc, argv);
-
-    Notepad notepad;
-    notepad.show();
-
-    return app.exec();
-}
-
-#include "main.moc"
-

examples/widgets/tutorials/gettingStarted/gsQt/part5/part5.pro

@@ -1,8 +0,0 @@
-QT += widgets
-requires(qtConfig(filedialog))
-SOURCES = main.cpp
-
-# install
-target.path = $$[QT_INSTALL_EXAMPLES]/widgets/tutorials/gettingStarted/gsQt/part5
-INSTALLS += target
-

examples/widgets/tutorials/tutorials.pro

@@ -1,2 +1,2 @@
 TEMPLATE = subdirs
-SUBDIRS += widgets modelview gettingStarted notepad
+SUBDIRS += widgets modelview notepad