Documenting QML

[RobM]

I have a question about QML documentation. If I use the \brief tag then the following sentence will be documented right, something like this:

/*!
  \brief GuidanceBarSettingsScreen.qml Is a 'Console' settings Screen.
*/

but what if I want a longer description to follow that? Can I just add it to the next line like so:

/*!
  \brief GuidanceBarSettingsScreen.qml Is a 'Console' settings Screen.
  
  This screen is part of the 'Console' settings and allows the user
  to enabled/disable certain guidance settings from within the
  settings window.
*/

Also, I know I can reference groups using the \ingroup tag, but how can I reference other QMl files? Is there an equivalent QML docs tag for the Doxygen tag: @ref ?

Also, what exactly is a QML class? Can any .qml technically be called a QML class? The only reason I ask is because here they differentiate a QML class from other QML items.

[fcarney]

\class in that context is referring to C++ classes. That page is not specific to QDoc in just QML.

It looks like from that page that \brief will capture a continuous set of text without an empty line in between.

so:

\brief blah blah blah
blah blah blah
blah blah blah

nope nope nope nope
nope nope nope nope
nope nope nope nope

This should keep the blah's in the brief and the nope's in the extended version, whenever that appears.

Edit: But, class may be appropriate to use before the meat of the code in a QML file. Unless there is a QML specific tag for this.