In QML when I have a property of type alias I can specify an actual property type in the \qmlproperty command:

/*!
    \qmlproperty int someAlias
    An alias
 */
property alias someAlias: someInt 

The property will be shown as int in the documentation.

However when the property is not an alias the same doesn't work and the type as written in the code will be shown. There's a few cases in which I found myself wanting to override the automatic type.

Override var with concrete type:

/*!
    \qmlproperty int someInt
*/
property var someInt 

Hide an irrelevant module prefix:

/*!
    \qmlproperty Action anAction
  
    An action
*/
property T.Action anAction 

Grouped properties:

/*!
    \qmlproperty string icon.name
    \qmlproperty color icon.color

    A grouped property
 */
property IconGroup icon 

In all these cases the type as spelled in the QML code is shown, not what is passed to \qmlproperty