Spelling Module Names in Qt Documentation: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
Line 1: Line 1:
=Spelling Module Names in Qt 5 Documentation=
[[Category:Developing_Qt::Documentation]]
 
= Spelling Module Names in Qt 5 Documentation =


Currently, Qt documentation uses various conventions for spelling module names, depending on the history of the module, the length of the name, and personal preferences of different writers.
Currently, Qt documentation uses various conventions for spelling module names, depending on the history of the module, the length of the name, and personal preferences of different writers.


The recommendation for consistent and readable spelling of module names in the documentation is as follows:
The recommendation for consistent and readable spelling of module names in the documentation is as follows:<br />* Use the Qt prefix. Instead of &quot;Core&amp;quot;, write '''Qt Core'''.<br />* Spell all words separated by white space and start all words with a capital letter. For example '''Qt Service Framework'''<br />* Acronyms and established names spelled in their standard format, for example '''Qt SQL''', '''Qt XML Patterns''', '''Qt D-Bus'''<br />* Don't use the module repository names qtbase, qtsystems, qtpim or qtconnectivity in the documentation. Instead, you should refer directly to the individual modules in those repositories.<br />* If the module name includes words like &quot;and&amp;quot;, they can be omitted in the source code name: '''Qt Publish and Subscribe''' is QtPublishSubscribe in the code<br />* Avoid abbreviations, because it is hard to be consistent with their usage. If you cannot avoid them, then make sure you use them consistently in the code and documentation. For example, since the source code spelling is QtSystemInfo, the documentation name should be '''Qt System Info''', not Qt System Information. And since the source code spelling is QtJsonDb, the documentation name is '''Qt JSON DB''', not &quot;Qt JSON Database&amp;quot;.
 
* Use the Qt prefix. Instead of “Core”, write '''Qt Core'''.
* Spell all words separated by white space and start all words with a capital letter. For example '''Qt Service Framework'''
* Acronyms and established names spelled in their standard format, for example '''Qt <span class="caps">SQL</span>''', '''Qt <span class="caps">XML</span> Patterns''', '''Qt D-Bus'''
* Don’t use the module repository names qtbase, qtsystems, qtpim or qtconnectivity in the documentation. Instead, you should refer directly to the individual modules in those repositories.
* If the module name includes words like “and”, they can be omitted in the source code name: '''Qt Publish and Subscribe''' is QtPublishSubscribe in the code
* Avoid abbreviations, because it is hard to be consistent with their usage. If you cannot avoid them, then make sure you use them consistently in the code and documentation. For example, since the source code spelling is QtSystemInfo, the documentation name should be '''Qt System Info''', not Qt System Information. And since the source code spelling is QtJsonDb, the documentation name is '''Qt <span class="caps">JSON</span> DB''', not “Qt <span class="caps">JSON</span> Database”.


In the code, the module names are used as header file names, and in <span class="caps">QML</span> import statements. In these cases, the module is spelled in CamelCase and without the separating white space.
In the code, the module names are used as header file names, and in QML import statements. In these cases, the module is spelled in CamelCase and without the separating white space.


The following table summarizes the correct spelling for the current modules in the plans for Qt 5.
The following table summarizes the correct spelling for the current modules in the plans for Qt 5.


{| class="infotable line"
{background:#009900}. |''. Module name in documentation|''. Module name in the code|<br />| Active Qt | QAxContainer, QAxServer and other names with the QAx prefix |<br />| Qt 3D | Qt3D |<br />| Qt Android Extras | QtAndroidExtras |<br />| Qt Bluetooth | QtBluetooth |<br />| Qt CLucene | QtCLucene |<br />| Qt Concurrent | QtConcurrent |<br />| Qt Contacts | QtContacts |<br />| Qt Core | QtCore |<br />| Qt D-Bus | QtDBus |<br />| Qt Designer | QtDesigner |<br />| Qt Feedback | QtFeedback |<br />| Qt Graphical Effects | QtGraphicalEffects |<br />| Qt GUI | QtGui |<br />| Qt Help | QtHelp |<br />| Qt JSON DB |QtJsonDb |<br />| Qt Location | QtLocation |<br />| Qt Mac Extras | QtMacExtras |<br />| Qt MIME Types | QtMimeTypes |<br />| Qt Multimedia | QtMultimedia |<br />| Qt Multimedia Widgets | QtMultimediaWidgets |<br />| Qt Network | QtNetwork |<br />| Qt NFC | QtNfc |<br />| Qt Organizer | QtOrganizer |<br />| Qt Positioning | QtPositioning |<br />| Qt Print Support | QtPrintSupport |<br />| Qt Publish and Subscribe | QtPublishSubscribe |<br />| Qt Quick (for Qt Quick 2.0) | QtQuick |<br />| Qt Quick (for Qt Quick 1.0 in the QML context) or Qt Declarative in the C++ context | QtQuick in QML, QtDeclarative in C++ |<br />| Qt Script | QtScript |<br />| Qt Script Tools | QtScriptTools |<br />| Qt Sensors | QtSensors |<br />| Qt Serial Port | QtSerialPort |<br />| Qt Service Framework | QtServiceFramework |<br />| Qt SQL | QtSql |<br />| Qt SVG | QtSvg |<br />| Qt System Info | QtSystemInfo |<br />| Qt Test | QtTest |<br />| Qt UI Tools | QtUiTools |<br />| Qt Versit | QtVersit |<br />| Qt Versit Organizer | QtVersitOrganizer |<br />| Qt Wayland | QtWayland |<br />| Qt WebChannel | QtWebChannel |<br />| Qt WebEngine | QtWebEngine |<br />| Qt WebKit | QtWebKit |<br />| Qt WebKit Widgets| QtWebKitWidgets |<br />| Qt Widgets | QtWidgets |<br />| Qt Windows Extras | QtWindowsExtras |<br />| Qt X11 Extras | QtX11Extras |<br />| Qt XML |QtXml |<br />| Qt XML Patterns | QtXmlPatterns |
|- style="background: #009900"
! Module name in documentation
! Module name in the code
|-
| Active Qt
| QAxContainer, QAxServer and other names with the QAx prefix
|-
| Qt 3D
| Qt3D
|-
| Qt Android Extras
| QtAndroidExtras
|-
| Qt Bluetooth
| QtBluetooth
|-
| Qt CLucene
| QtCLucene
|-
| Qt Concurrent
| QtConcurrent
|-
| Qt Contacts
| QtContacts
|-
| Qt Core
| QtCore
|-
| Qt D-Bus
| QtDBus
|-
| Qt Designer
| QtDesigner
|-
| Qt Feedback
| QtFeedback
|-
| Qt Graphical Effects
| QtGraphicalEffects
|-
| Qt <span class="caps">GUI</span>
| QtGui
|-
| Qt Help
| QtHelp
|-
| Qt <span class="caps">JSON</span> DB
| QtJsonDb
|-
| Qt Location
| QtLocation
|-
| Qt Mac Extras
| QtMacExtras
|-
| Qt <span class="caps">MIME</span> Types
| QtMimeTypes
|-
| Qt Multimedia
| QtMultimedia
|-
| Qt Multimedia Widgets
| QtMultimediaWidgets
|-
| Qt Network
| QtNetwork
|-
| Qt <span class="caps">NFC</span>
| QtNfc
|-
| Qt Organizer
| QtOrganizer
|-
| Qt Positioning
| QtPositioning
|-
| Qt Print Support
| QtPrintSupport
|-
| Qt Publish and Subscribe
| QtPublishSubscribe
|-
| Qt Quick (for Qt Quick 2.0)
| QtQuick
|-
| Qt Quick (for Qt Quick 1.0 in the <span class="caps">QML</span> context) or Qt Declarative in the C++ context
| QtQuick in <span class="caps">QML</span>, QtDeclarative in C++
|-
| Qt Script
| QtScript
|-
| Qt Script Tools
| QtScriptTools
|-
| Qt Sensors
| QtSensors
|-
| Qt Serial Port
| QtSerialPort
|-
| Qt Service Framework
| QtServiceFramework
|-
| Qt <span class="caps">SQL</span>
| QtSql
|-
| Qt <span class="caps">SVG</span>
| QtSvg
|-
| Qt System Info
| QtSystemInfo
|-
| Qt Test
| QtTest
|-
| Qt UI Tools
| QtUiTools
|-
| Qt Versit
| QtVersit
|-
| Qt Versit Organizer
| QtVersitOrganizer
|-
| Qt Wayland
| QtWayland
|-
| Qt WebChannel
| QtWebChannel
|-
| Qt WebEngine
| QtWebEngine
|-
| Qt WebKit
| QtWebKit
|-
| Qt WebKit Widgets
| QtWebKitWidgets
|-
| Qt Widgets
| QtWidgets
|-
| Qt Windows Extras
| QtWindowsExtras
|-
| Qt X11 Extras
| QtX11Extras
|-
| Qt <span class="caps">XML</span>
| QtXml
|-
| Qt <span class="caps">XML</span> Patterns
| QtXmlPatterns
|}
 
===Categories:===
 
* [[:Category:Developing Qt|Developing_Qt]]
** [[:Category:Developing Qt::Documentation|Documentation]]

Revision as of 10:46, 24 February 2015


Spelling Module Names in Qt 5 Documentation

Currently, Qt documentation uses various conventions for spelling module names, depending on the history of the module, the length of the name, and personal preferences of different writers.

The recommendation for consistent and readable spelling of module names in the documentation is as follows:
* Use the Qt prefix. Instead of "Core&quot;, write Qt Core.
* Spell all words separated by white space and start all words with a capital letter. For example Qt Service Framework
* Acronyms and established names spelled in their standard format, for example Qt SQL, Qt XML Patterns, Qt D-Bus
* Don't use the module repository names qtbase, qtsystems, qtpim or qtconnectivity in the documentation. Instead, you should refer directly to the individual modules in those repositories.
* If the module name includes words like "and&quot;, they can be omitted in the source code name: Qt Publish and Subscribe is QtPublishSubscribe in the code
* Avoid abbreviations, because it is hard to be consistent with their usage. If you cannot avoid them, then make sure you use them consistently in the code and documentation. For example, since the source code spelling is QtSystemInfo, the documentation name should be Qt System Info, not Qt System Information. And since the source code spelling is QtJsonDb, the documentation name is Qt JSON DB, not "Qt JSON Database&quot;.

In the code, the module names are used as header file names, and in QML import statements. In these cases, the module is spelled in CamelCase and without the separating white space.

The following table summarizes the correct spelling for the current modules in the plans for Qt 5.

{background:#009900}. |. Module name in documentation|. Module name in the code|
| Active Qt | QAxContainer, QAxServer and other names with the QAx prefix |
| Qt 3D | Qt3D |
| Qt Android Extras | QtAndroidExtras |
| Qt Bluetooth | QtBluetooth |
| Qt CLucene | QtCLucene |
| Qt Concurrent | QtConcurrent |
| Qt Contacts | QtContacts |
| Qt Core | QtCore |
| Qt D-Bus | QtDBus |
| Qt Designer | QtDesigner |
| Qt Feedback | QtFeedback |
| Qt Graphical Effects | QtGraphicalEffects |
| Qt GUI | QtGui |
| Qt Help | QtHelp |
| Qt JSON DB |QtJsonDb |
| Qt Location | QtLocation |
| Qt Mac Extras | QtMacExtras |
| Qt MIME Types | QtMimeTypes |
| Qt Multimedia | QtMultimedia |
| Qt Multimedia Widgets | QtMultimediaWidgets |
| Qt Network | QtNetwork |
| Qt NFC | QtNfc |
| Qt Organizer | QtOrganizer |
| Qt Positioning | QtPositioning |
| Qt Print Support | QtPrintSupport |
| Qt Publish and Subscribe | QtPublishSubscribe |
| Qt Quick (for Qt Quick 2.0) | QtQuick |
| Qt Quick (for Qt Quick 1.0 in the QML context) or Qt Declarative in the C++ context | QtQuick in QML, QtDeclarative in C++ |
| Qt Script | QtScript |
| Qt Script Tools | QtScriptTools |
| Qt Sensors | QtSensors |
| Qt Serial Port | QtSerialPort |
| Qt Service Framework | QtServiceFramework |
| Qt SQL | QtSql |
| Qt SVG | QtSvg |
| Qt System Info | QtSystemInfo |
| Qt Test | QtTest |
| Qt UI Tools | QtUiTools |
| Qt Versit | QtVersit |
| Qt Versit Organizer | QtVersitOrganizer |
| Qt Wayland | QtWayland |
| Qt WebChannel | QtWebChannel |
| Qt WebEngine | QtWebEngine |
| Qt WebKit | QtWebKit |
| Qt WebKit Widgets| QtWebKitWidgets |
| Qt Widgets | QtWidgets |
| Qt Windows Extras | QtWindowsExtras |
| Qt X11 Extras | QtX11Extras |
| Qt XML |QtXml |
| Qt XML Patterns | QtXmlPatterns |