Updates the coding convention snippets and example to some of the
current QML guidelines, such as: no parenthesis for single arg signal
handlers and semicolons in multiline blocks. These rules are also
enforced by the qmlformat tool, so it makes sense for the docs to also
reflect this.
Pick-to: 6.5 6.6 6.7
Change-Id: Iae38d1b32b6550e3f880182d064ee30194e21603
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
Replace the current license disclaimer in files by
a SPDX-License-Identifier.
License files are organized under LICENSES directory.
Pick-to: 6.4
Task-number: QTBUG-67283
Change-Id: Idfd176b7f7b077a5b7c66b7738dc9bcac94ab290
Reviewed-by: Qt CI Bot <qt_ci_bot@qt-project.org>
Reviewed-by: Jörg Bornemann <joerg.bornemann@qt.io>
-Remove content about mobile APIs and multimedia
-Add links to other Qt reference and manuals
-Add snippet to show basic QML and controls
Task-number: QTBUG-87158
Task-number: QTBUG-87744
Change-Id: If320b52f257b1cfb2857d0f2f76262e748473f36
Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
States and transitions are not special on a language level.
They should be written along with other object properties.
Also updates the example to no longer use the undesirable syntax for Lists.
Change-Id: Ib20eb768bd9f6c96b6850cd714f47cda45ce69b9
Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
Reviewed-by: Shawn Rutledge <shawn.rutledge@qt.io>
Reviewed-by: Ulf Hermann <ulf.hermann@qt.io>
Assigning a single item to a List property without braces makes it ambiguous whether the property is a list or scalar.
It should therefore not be encouraged to use this syntax.
Change-Id: I1e681ae654b45c830823072a03dca93be674d917
Reviewed-by: Fabian Kosmale <fabian.kosmale@qt.io>
In addition, updated a snippet file and added another
to complement the text.
Task-number: QTBUG-70333
Change-Id: I20e8e13390a00151d040f92d7a54c661e64c17e3
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
Reviewed-by: Shawn Rutledge <shawn.rutledge@qt.io>
The point of the convention was that related properties should be part
of the same "block" or "group" of assignments, which can be achieved by
ensuring that they are directly above/below one another. Bunching up
assignments onto one line for a few properties should not be a
recommended practice.
Change-Id: Ie84163b3261e7138d69678e059a91c2c82b43507
Reviewed-by: Simon Hausmann <simon.hausmann@qt.io>
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
The concensus to use semicolons for blocks of code was reached on the
mailing list:
http://lists.qt-project.org/pipermail/development/2016-October/027441.html
Change-Id: I98ce87c623c189bdfac8cfac5c0fa80e5a831c18
Reviewed-by: Kai Koehne <kai.koehne@qt.io>
Reviewed-by: Simon Hausmann <simon.hausmann@qt.io>
Reviewed-by: Robin Burchell <robin.burchell@viroteck.net>
Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>
Reviewed-by: Topi Reiniö <topi.reinio@theqtcompany.com>
Qt copyrights are now in The Qt Company, so we could update the source
code headers accordingly. In the same go we should also fix the links to
point to qt.io.
Change-Id: Iedecec76f88fcf709d31bf7bfc5fe817302ecae1
Reviewed-by: Topi Reiniö <topi.reinio@digia.com>
-focused on styling the controls
-removed section about customizing properties (already covered)
-revised the section about SystemPalette
Task-number: QTBUG-33595
Change-Id: I065971fa9ab57e5eacf83077925ccb52c9f9717d
Reviewed-by: Venugopal Shivashankar <venugopal.shivashankar@digia.com>
It doesn't make sense to advocate the use of QtQuick 2.0 anymore. We
can expect that people target Qt 5.3 in the Qt 5.3 documentation ...
Change-Id: I6ac8dca59a2717fe6d8baec13d968bd74070e90e
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>
-ported from qtdeclarative.git
-fixed snippet and image paths to doc/snippets and doc/images
Because this guide will need to cover more than Qt QML and Qt Quick,
this guide does not need to be in qtdeclarative.
Change-Id: Id6a47420a1e73b5c55b7233571557e3558e82043
Reviewed-by: Sze Howe Koh <szehowe.koh@gmail.com>
Reviewed-by: Geir Vattekar <geir.vattekar@digia.com>