66fc052754
The signals and slots syntax documentation previously contained detailed examples for connecting to overloaded functions, but comprehensive overload connection guidance has now been moved to the main signals and slots documentation in qtbase. This created content duplication and potential maintenance issues across the documentation set. This change removes the duplicate detailed examples and replaces them with a clear reference to the comprehensive documentation. The existing snippet demonstrating basic overload syntax remains, but the extensive explanatory content now defers to the authoritative source in qtbase. This eliminates redundancy while maintaining the document's focus on syntax differences between connection approaches. The change also removes references to older C++ standards since Qt 6 requires C++17, ensuring the documentation reflects current requirements. Task-number: QTBUG-89600 Pick-to: 6.10 6.9 6.8 Change-Id: I35c25f6969086cd872343ab13a7577e3ba460115 Reviewed-by: Sze Howe Koh <szehowe.koh@gmail.com> |
||
|---|---|---|
| LICENSES | ||
| coin | ||
| dist | ||
| doc | ||
| examples | ||
| tests | ||
| .cmake.conf | ||
| .gitattributes | ||
| .gitignore | ||
| .gitreview | ||
| .tag | ||
| CMakeLists.txt | ||
| README.md | ||
| REUSE.toml | ||
| dependencies.yaml | ||
| licenseRule.json | ||
README.md
Qt Documentation
This repository contains the main Qt Reference Documentation, including overviews, Qt topics, examples, and tutorials not specific to any Qt module.
Documentation Projects
The documentation is organized into several documentation projects:
QtDoc
The main Qt Reference Documentation.
Project File: doc/config/qtdoc.qdocconf
Sources: doc/src/ (excluding cmake/ and platformintegration/
subdirectories)
Content:
- Getting started guides and tutorials
- Platform-specific documentation (Android, iOS, macOS, Windows, etc.)
- Qt modules overview and reference
- Development tools and utilities
- Legal information and licenses
- Examples and demos
CMake Targets: docs_QtDoc or html_docs_QtDoc
This project also contains the documentation for examples and tutorials in
the examples/ directory.
QtCMake
Documentation for using Qt with CMake.
Project File: doc/src/cmake/qtcmake.qdocconf
Sources: doc/src/cmake
Content:
- CMake manual and getting started guide
- Qt CMake API reference
- Build system configuration
CMake Targets: docs_qtcmake or html_docs_qtcmake.
QtPlatformIntegration
Documentation for integrating Qt with native platforms.
Project File: doc/src/platformintegration/qtplatformintegration.qdocconf
Sources: doc/src/platformintegration/
Content:
- Qt Platform Abstraction (QPA)
- Platform-specific integration guides
- Native API interaction
CMake Targets: docs_QtPlatformIntegration or html_docs_QtPlatformIntegration.
Building Documentation
The main QtDoc documentation contains links to pages from other documentation projects (QtCore, QtQuick, etc.). Similarly, these projects link back to pages and topics in QtDoc.
Therefore, the most reliable approach is to build Qt documentation as part of a complete Qt build that includes all supported Qt modules. Refer to the README.md in qt5.git for detailed instructions.
Building Examples
Build the examples by opening the CMakeLists.txt files in the respective example directory.
Writing and Improving Qt Documentation
Qt Documentation is written in QDoc syntax. See https://doc.qt.io/qt-6/qdoc-index.html for the QDoc manual.
For more information about Qt's documentation, refer to the Qt Project wiki: https://wiki.qt.io/Qt_Writing_Guidelines
Writing and Improving Qt Examples
See https://contribute.qt-project.org/quips/13 for some guidance around the Qt examples.