From 506c74d7827a2199ddf4f9b9e18090ba30e52f1c Mon Sep 17 00:00:00 2001 From: Ulf Hermann Date: Mon, 30 Jan 2023 13:41:39 +0100 Subject: Doc: Update qmlformat description The behavior of qmlformat has changed. Update the documentation to reflect it. Pick-to: 6.5 Fixes: QTBUG-107213 Change-Id: I7a53ad7b62edce0f078782dbef340236d20c9781 Reviewed-by: Fabian Kosmale --- src/quick/doc/src/guidelines/qtquick-toolsnutilities.qdoc | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/src/quick/doc/src/guidelines/qtquick-toolsnutilities.qdoc b/src/quick/doc/src/guidelines/qtquick-toolsnutilities.qdoc index 0a7c4194d0..50b929e0ed 100644 --- a/src/quick/doc/src/guidelines/qtquick-toolsnutilities.qdoc +++ b/src/quick/doc/src/guidelines/qtquick-toolsnutilities.qdoc @@ -79,17 +79,20 @@ flag for doing so by passing \c{--help} on the command line. \e qmlformat is a tool that automatically formats QML files in accordance with the \l{QML Coding Conventions}. -The tool groups all properties, functions, and signals together, instead of -retaining the order you specified. - -Imports will also be sorted in alphabetical order. This can be disabled -by specifying the \c{-n} flag. +If you pass the \c{-n} or \c{--normalize} flag, \e qmlformat groups all +properties, functions, and signals together, instead of retaining the order you +specified. By default, qmlformat writes the formatted version of the file to stdout. If you wish to have your file updated in-place specify the \c{-i} flag. You may also change tab widths and line ending types among other settings, -either via command line options or by using a settings file. +either via command line options or by using a settings file called +\c{.qmlformat.ini}. A default settings file can be obtained by passing the +\c{--write-defaults} flag. + +As with all tools, the \c{-h} or \c{--help} flag will print some information on +all the available options. \section1 Qt Quick Compiler -- cgit v1.2.3