// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
\page qtqml-tooling-qmlpreview.html
\title qmlpreview
\brief A tool that provides a live updating preview for the QML files.
\ingroup qtqml-tooling
\ingroup qtqml-tooling-design

\section1 The Qml Preview
The QML Preview tool watches QML and JavaScript files on disk and updates
the application live with any changes. The application to be previewed
has to have QML debugging enabled. \l {details}{More...}

\table
\header
    \li Usage
\row
    \li qmlpreview [\l{options}] executable [parameters...]
\endtable

\section2 options

\table
\header
    \li Option
    \li Description
\row
    \li   --verbose
    \li Print debugging output.
\row
    \li -h, --help
    \li Displays help on commandline options.
\row
    \li --help-all
    \li Displays help, including generic Qt options.
\row
    \li -v, --version
    \li Displays version information.
\endtable

\section2 Arguments

\table
    \header
        \li Argument
        \li Description
    \row
        \li executable
        \li The path of the executable file that loads a QML document.
    \row
        \li parameters
        \li Arguments of the executable

\endtable

\section2 Details
\target details

\section3 Enable QML Debugging

To use \c{qmlpreview} on an executable, the executable must be built
with the \l{QML debugging infrastructure} enabled.

*/
