Qt5APIDocumentation: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
h1. Qt 5 API Documentation
{{Cleanup | reason=Auto-imported from ExpressionEngine.}}


Essentially, for each module we need:
Essentially, for each module we need:
Line 20: Line 20:
===== qdocconf files =====
===== qdocconf files =====


Each module needs a "qdocconf":http://doc-snapshot.qt.io/qdoc/qdoc-guide-conf.html file to generate a documentation set for each module.
Each module needs a [http://doc-snapshot.qt.io/qdoc/qdoc-guide-conf.html qdocconf] file to generate a documentation set for each module.
Because of the [[Qt_Documentation_Structure | documentation structure]], there is a common qdocconf file and template modules may use.
Because of the [[Qt_Documentation_Structure | documentation structure]], there is a common qdocconf file and template modules may use.


Line 33: Line 33:
The [[:Category:Developing_Qt::Documentation|Documentation]] page has information about contributing to the documentation.
The [[:Category:Developing_Qt::Documentation|Documentation]] page has information about contributing to the documentation.


=== Essentials
=== Essentials ===
{background:#009900}. |''. Git repo |''. Module |''. Responsible |''. Status (A,B,C,D) |''. URL |''. Comment |''. qdocconf |''. Release |
 
| qtbase | Qt Core | Thiago | | http://doc-snapshot.qt.io/5.0/qtcore-index.html | | | Qt 5.0 |
{| class="wikitable"
| qtbase | Qt GUI | Samuel | ABC | http://doc-snapshot.qt.io/5.0/qtgui-overview.html | | | Qt 5.0 |
! Git repo  
| qtbase | Qt Network | Jerome | ABCD | http://doc-snapshot.qt.io/5.0/qtnetwork-index.html | | OK | Qt 5.0 |
! Module  
| qtbase | Qt SQL |Jerome | ABCD | http://doc-snapshot.qt.io/5.0/qtsql-index.html | | OK | Qt 5.0 |
! Responsible  
| qtbase | Qt Test | Leena | AC | | In Gerrit | OK | Qt 5.0 |
! Status (A,B,C,D)  
| qtdeclarative | Qt QML | Jerome | ABC | http://doc-snapshot.qt.io/5.0/qtqml-index.html | Qt Quick contains the QML types | OK | Qt 5.0 |
! URL  
| qtdeclarative | Qt Quick | Jerome | ABCD | http://doc-snapshot.qt.io/5.0/qtquick-index.html | | OK | Qt 5.0 |
! Comment  
| qtmultimedia | Qt Multimedia | Venugopal | ABCD | http://doc-snapshot.qt.io/5.0/qtmultimedia-index.html | | OK | Qt 5.0 |
! qdocconf  
| qtwebkit | Qt WebKit | Pierre | | http://doc-snapshot.qt.io/5.0/qtwebkit-module.html | candidate landing page (needs editing) | | Qt 5.0 | ===
! Release  
|-
| qtbase  
| Qt Core  
| Thiago  
|  
| http://doc-snapshot.qt.io/5.0/qtcore-index.html  
|  
|  
| Qt 5.0  
|-
| qtbase  
| Qt GUI  
| Samuel  
| ABC  
| http://doc-snapshot.qt.io/5.0/qtgui-overview.html  
|  
|  
| Qt 5.0  
|-
| qtbase  
| Qt Network  
| Jerome  
| ABCD  
| http://doc-snapshot.qt.io/5.0/qtnetwork-index.html  
|  
| OK  
| Qt 5.0  
|-
| qtbase  
| Qt SQL  
| Jerome  
| ABCD  
| http://doc-snapshot.qt.io/5.0/qtsql-index.html  
|  
| OK  
| Qt 5.0  
|-
| qtbase  
| Qt Test  
| Leena  
| AC  
|  
| In Gerrit  
| OK  
| Qt 5.0  
|-
| qtdeclarative  
| Qt QML
| Jerome  
| ABC  
| http://doc-snapshot.qt.io/5.0/qtqml-index.html  
| Qt Quick contains the QML types  
| OK  
| Qt 5.0  
|-
| qtdeclarative  
| Qt Quick  
| Jerome  
| ABCD  
| http://doc-snapshot.qt.io/5.0/qtquick-index.html  
|  
| OK  
| Qt 5.0  
|-
| qtmultimedia  
| Qt Multimedia  
| Venugopal  
| ABCD  
| http://doc-snapshot.qt.io/5.0/qtmultimedia-index.html  
|  
| OK  
| Qt 5.0  
|-
| qtwebkit  
| Qt WebKit  
| Pierre  
|  
| http://doc-snapshot.qt.io/5.0/qtwebkit-module.html  
| candidate landing page (needs editing)  
|  
| Qt 5.0  
|}


(the C++ classes or QML type pages should be linked to from the landing pages, if applicable)
(the C++ classes or QML type pages should be linked to from the landing pages, if applicable)


=== Qt Add-ons
=== Qt Add-ons ===
{background:#009900}. |''. Git repo |''. Module |''. Responsible |''. Status (A,B,C,D)|''. URL |''. Comment |''. qdocconf|''. Release |
 
| qt3d | Qt 3D | | AC | http://doc-snapshot.qt.io/5.0/qt3d-index.html | | OK | |
{| class="wikitable"
| qtbase | Qt Concurrent | Morten? | | | | | Qt 5.0 |
! Git repo  
| qtbase | Qt D-Bus | Thiago | | | | | Qt 5.0 |
! Module  
| qtbase | Qt OpenGL | | | | | | Qt 5.0 |
! Responsible  
| qtbase | Qt Print Support | | | | | | Qt 5.0 |
! Status (A,B,C,D)
| qtbase | Qt Widgets | Jan-Arve, Jens | ABC |http://doc-snapshot.qt.io/5.0/qtwidgets-index.html | | | Qt 5.0 |
! URL  
| qtbase | Qt XML | | | | | | Qt 5.0 |
! Comment  
| qtconnectivity| Qt Bluetooth | Jerome | ABC | http://doc-snapshot.qt.io/5.0/qtbluetooth-index.html | | OK | |
! qdocconf
| qtgraphicaleffects | Qt Graphical Effects | Jerome | AD | http://doc-snapshot.qt.io/5.0/qtgraphicaleffects-index.html | doesn't need example page; no C++ class | OK | Qt 5.0 |
! Release  
| qtimageformats | Qt Image Formats | | | | | | Qt 5.0 |
|-
| qtlocation | Qt Location | | | | | | |
| qt3d  
| qtquick1 | Qt Quick 1 | | | | | | Qt 5.0 |
| Qt 3D  
| qtscript | Qt Script | | | | | | Qt 5.0 |
|  
| qtsensors | Qt Sensors | Geir | AB | | | | |
| AC  
| qtsvg | Qt SVG | Geir | | | | | Qt 5.0 |
| http://doc-snapshot.qt.io/5.0/qt3d-index.html  
| qtsystems | Qt System Info | Geir | | | | | |
|  
| qttools | Qt Designer | | | | | | Qt 5.0 |
| OK  
| qttools | Qt Help | | | | | | Qt 5.0 |
|  
| qttools | Qt UI Tools | | | | | | Qt 5.0 |
|-
| qtwayland | Qt Wayland | Paul | | | | | |
| qtbase  
| qtxmlpatterns | Qt XML Patterns| | | | | | Qt 5.0 | ===
| Qt Concurrent  
| Morten?  
|  
|  
|  
|  
| Qt 5.0  
|-
| qtbase  
| Qt D-Bus  
| Thiago  
|  
|  
|  
|  
| Qt 5.0  
|-
| qtbase  
| Qt OpenGL  
|  
|  
|  
|  
|  
| Qt 5.0  
|-
| qtbase  
| Qt Print Support  
|  
|  
|  
|  
|  
| Qt 5.0  
|-
| qtbase  
| Qt Widgets  
| Jan-Arve, Jens  
| ABC |http://doc-snapshot.qt.io/5.0/qtwidgets-index.html  
|  
|  
| Qt 5.0  
|-
| qtbase  
| Qt XML  
|  
|  
|  
|  
|  
| Qt 5.0  
|-
| qtconnectivity
| Qt Bluetooth  
| Jerome  
| ABC  
| http://doc-snapshot.qt.io/5.0/qtbluetooth-index.html  
|  
| OK  
|  
|-
| qtgraphicaleffects  
| Qt Graphical Effects  
| Jerome  
| AD  
| http://doc-snapshot.qt.io/5.0/qtgraphicaleffects-index.html  
| doesn't need example page; no C++ class  
| OK  
| Qt 5.0  
|-
| qtimageformats  
| Qt Image Formats  
|  
|  
|  
|  
|  
| Qt 5.0  
|-
| qtlocation  
| Qt Location  
|  
|  
|  
|  
|  
|  
|-
| qtquick1  
| Qt Quick 1  
|  
|  
|  
|  
|  
| Qt 5.0  
|-
| qtscript  
| Qt Script  
|  
|  
|  
|  
|  
| Qt 5.0  
|-
| qtsensors  
| Qt Sensors  
| Geir  
| AB  
|  
|  
|  
|  
|-
| qtsvg  
| Qt SVG  
| Geir  
|  
|  
|  
|  
| Qt 5.0  
|-
| qtsystems  
| Qt System Info  
| Geir  
|  
|  
|  
|  
|  
|-
| qttools  
| Qt Designer  
|  
|  
|  
|  
|  
| Qt 5.0  
|-
| qttools  
| Qt Help  
|  
|  
|  
|  
|  
| Qt 5.0  
|-
| qttools  
| Qt UI Tools  
|  
|  
|  
|  
|  
| Qt 5.0  
|-
| qtwayland  
| Qt Wayland  
| Paul  
|  
|  
|  
|  
|  
|-
| qtxmlpatterns  
| Qt XML Patterns
|  
|  
|  
|  
|  
| Qt 5.0  
|}
 
=== Additional Modules ===


=== Additional Modules
{| class="wikitable"
{background:#009900}. |''. Git repo |''. Module |''. Responsible |''. Status |''. URL |''. Comment |''. qdocconf |''. Release |
! Git repo  
| qtactiveqt | Active Qt | Leena | | | On hold, as I cannot test this on my Mac | | Qt 5.0 |
! Module  
| qtfeedback | Qt Feedback | | | | | | |
! Responsible  
| qtjsbackend | | | | | | | Qt 5.0 |
! Status  
| qtjsondb | Qt JSON DB | | | | | | |
! URL  
| qtlalr | Qt QLALR | | | | | | |
! Comment  
| qtpim | Qt Contacts | Jerome | ACD | http://doc-snapshot.qt.io/5.0/qtcontacts-index.html | | OK | |
! qdocconf  
| qtpim | Qt Organizer | Jerome | ACD |http://doc-snapshot.qt.io/5.0/qtorganizer-index.html | | OK | |
! Release  
| qtpim | Qt Versit | Jerome | AC | http://doc-snapshot.qt.io/5.0/qtversit-index.html | | OK | |
|-
| qtqa | Qt QA | | | | | | |
| qtactiveqt  
| qtrepotools | | | | | | | |
| Active Qt  
| qtsystems | Qt Publish and Subscribe | Geir | | | | | |
| Leena  
| qtsystems | Qt Service Framework | Geir | | | | | | ===
|  
|  
| On hold, as I cannot test this on my Mac  
|  
| Qt 5.0  
|-
| qtfeedback  
| Qt Feedback  
|  
|  
|  
|  
|  
|  
|-
| qtjsbackend  
|  
|  
|  
|  
|  
|  
| Qt 5.0  
|-
| qtjsondb  
| Qt JSON DB  
|  
|  
|  
|  
|  
|  
|-
| qtlalr  
| Qt QLALR  
|  
|  
|  
|  
|  
|  
|-
| qtpim  
| Qt Contacts  
| Jerome  
| ACD  
| http://doc-snapshot.qt.io/5.0/qtcontacts-index.html  
|  
| OK  
|  
|-
| qtpim  
| Qt Organizer  
| Jerome  
| ACD  
|http://doc-snapshot.qt.io/5.0/qtorganizer-index.html  
|  
| OK  
|  
|-
| qtpim  
| Qt Versit  
| Jerome  
| AC  
| http://doc-snapshot.qt.io/5.0/qtversit-index.html  
|  
| OK  
|  
|-
| qtqa  
| Qt QA  
|  
|  
|  
|  
|  
|  
|-
| qtrepotools  
|  
|  
|  
|  
|  
|  
|  
|-
| qtsystems  
| Qt Publish and Subscribe  
| Geir  
|  
|  
|  
|  
|  
|-
| qtsystems  
| Qt Service Framework  
| Geir  
|  
|  
|  
|  
|  
|}

Latest revision as of 10:56, 31 March 2015

This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine.
Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

Essentially, for each module we need:

  • A - landing page (using the command) see specifications
  • B - example page
  • C - c++ class list (using the command)
  • D - qml type list (command)

For example: Qt 3D:

  • -module name is 'Qt 3D'
  • -library in the module is 'Qt3D'
  • -landing page is qt3d-index.html with title 'Qt 3D' (http://doc-snapshot.qt.io/5.0/qt3d-index.html)
  • -c++ list has title 'Qt 3D C++ Classes'
  • -qml list has title 'Qt 3D QML Types'
  • -qt3d-examples.html for the example page

This is to clearly distinguish the pages because and pages confuse people with the word 'module' in it. Meaning, lets minimize the generic use of 'module'. The other thing to watch out for is the library name versus module name. Avoid 'Qt3D' when referring to Qt 3D. Spelling_Module_Names_in_Qt_Documentation lists the names.

qdocconf files

Each module needs a qdocconf file to generate a documentation set for each module. Because of the  documentation structure, there is a common qdocconf file and template modules may use.

Process

Each module has a main contact for document issues who can oversee the modularization and documentation issues. This responsible person does not need to be a module maintainer. For classes, an individual may edit documentation for technical and style correctness.

To sign up for the individual, you may sign up at Qt5ClassDocumentationCleanUp.

The Documentation page has information about contributing to the documentation.

Essentials

Git repo Module Responsible Status (A,B,C,D) URL Comment qdocconf Release
qtbase Qt Core Thiago http://doc-snapshot.qt.io/5.0/qtcore-index.html Qt 5.0
qtbase Qt GUI Samuel ABC http://doc-snapshot.qt.io/5.0/qtgui-overview.html Qt 5.0
qtbase Qt Network Jerome ABCD http://doc-snapshot.qt.io/5.0/qtnetwork-index.html OK Qt 5.0
qtbase Qt SQL Jerome ABCD http://doc-snapshot.qt.io/5.0/qtsql-index.html OK Qt 5.0
qtbase Qt Test Leena AC In Gerrit OK Qt 5.0
qtdeclarative Qt QML Jerome ABC http://doc-snapshot.qt.io/5.0/qtqml-index.html Qt Quick contains the QML types OK Qt 5.0
qtdeclarative Qt Quick Jerome ABCD http://doc-snapshot.qt.io/5.0/qtquick-index.html OK Qt 5.0
qtmultimedia Qt Multimedia Venugopal ABCD http://doc-snapshot.qt.io/5.0/qtmultimedia-index.html OK Qt 5.0
qtwebkit Qt WebKit Pierre http://doc-snapshot.qt.io/5.0/qtwebkit-module.html candidate landing page (needs editing) Qt 5.0

(the C++ classes or QML type pages should be linked to from the landing pages, if applicable)

Qt Add-ons

Git repo Module Responsible Status (A,B,C,D) URL Comment qdocconf Release
qt3d Qt 3D AC http://doc-snapshot.qt.io/5.0/qt3d-index.html OK
qtbase Qt Concurrent Morten? Qt 5.0
qtbase Qt D-Bus Thiago Qt 5.0
qtbase Qt OpenGL Qt 5.0
qtbase Qt Print Support Qt 5.0
qtbase Qt Widgets Jan-Arve, Jens http://doc-snapshot.qt.io/5.0/qtwidgets-index.html Qt 5.0
qtbase Qt XML Qt 5.0
qtconnectivity Qt Bluetooth Jerome ABC http://doc-snapshot.qt.io/5.0/qtbluetooth-index.html OK
qtgraphicaleffects Qt Graphical Effects Jerome AD http://doc-snapshot.qt.io/5.0/qtgraphicaleffects-index.html doesn't need example page; no C++ class OK Qt 5.0
qtimageformats Qt Image Formats Qt 5.0
qtlocation Qt Location
qtquick1 Qt Quick 1 Qt 5.0
qtscript Qt Script Qt 5.0
qtsensors Qt Sensors Geir AB
qtsvg Qt SVG Geir Qt 5.0
qtsystems Qt System Info Geir
qttools Qt Designer Qt 5.0
qttools Qt Help Qt 5.0
qttools Qt UI Tools Qt 5.0
qtwayland Qt Wayland Paul
qtxmlpatterns Qt XML Patterns Qt 5.0

Additional Modules

Git repo Module Responsible Status URL Comment qdocconf Release
qtactiveqt Active Qt Leena On hold, as I cannot test this on my Mac Qt 5.0
qtfeedback Qt Feedback
qtjsbackend Qt 5.0
qtjsondb Qt JSON DB
qtlalr Qt QLALR
qtpim Qt Contacts Jerome ACD http://doc-snapshot.qt.io/5.0/qtcontacts-index.html OK
qtpim Qt Organizer Jerome ACD http://doc-snapshot.qt.io/5.0/qtorganizer-index.html OK
qtpim Qt Versit Jerome AC http://doc-snapshot.qt.io/5.0/qtversit-index.html OK
qtqa Qt QA
qtrepotools
qtsystems Qt Publish and Subscribe Geir
qtsystems Qt Service Framework Geir