QDoc probelm: no Qt-specific types are detected.

[Ankalagon]

Hi,
I've the following problem when using qdoc:
everything that has to do with qt-specific types like "qreal". "QString" etc. is not recognized. The generated files show only "int" as type.
When using the \fn tag there is a warning:

(qdoc) warning: clang couldn't find function when parsing \fn qreal MyClass::sampleFunc(qreal input)

I'm very new to QDoc so I'm a little lost here.

[SGaist]

Hi,

Can you share the header and code of that class ?
From the looks of it, it seems to not find the implementation of the function.

[Ankalagon]

Sorry, forgot about that.

myclass.h:

#ifndef MYCLASS_H
#define MYCLASS_H

#include <QtCore>
#include <QObject>
#include <QQuickItem>

class MyClass : public QObject
{
    Q_OBJECT
    Q_DISABLE_COPY(MyClass)
    QML_SINGLETON
public:
    explicit MyClass(QObject *parent = nullptr);
    static MyClass *instance();
    static QObject* qmlInstance(QQmlEngine *engine, QJSEngine* scriptEngine);
    void registerTypes() {
        qmlRegisterSingletonType<MyClass>("MyClass",1,0,"MyClass",&MyClass::qmlInstance);
    }
    qreal sampleFunc(qreal input);
private:
    static MyClass *m_pThis;
};

#endif // MYCLASS_H

myclass.cpp:

#include "myclass.h"

MyClass *MyClass::m_pThis = nullptr;
MyClass *MyClass::instance() {
    if(m_pThis == nullptr) {
        m_pThis = new MyClass;
    }
    return m_pThis;
}

MyClass::MyClass(QObject *parent)
    : QObject(parent)
{
    registerTypes();
}
/*!
 * \brief MyClass::sampleFunc.
 * \fn qreal MyClass::sampleFunc(qreal input)
 * \a input
 */
qreal MyClass::sampleFunc(qreal input) {
    return input;
}

MyClass.qdoc:

/*!
  \class MyClass
  \inmodule MyClass
  \title MyClass
  */ 

MyClass.qdocconf:

project = MyClass
description = MyClass Doc

sourcedirs = .
headerdirs = .

sources.fileextensions = "*.cpp *.qdoc *.mm *.qml"
headers.fileextensions = "*.h *.ch *.h++ *.hh *.hpp *.hxx"


outputdir  =    ./html
outputformats = HTML

[SGaist]

Shouldn't fn be the first line ?

[Ankalagon]

Sadly that doesnt change anything.

[JoeCFD]

Just curious(not doc related): how can sampleFunc(qreal input) be called since m_pThis is static?

[SGaist]

Which version of Qt are you using ?
On which OS ?

[Ankalagon]

I'm using Qt 5.15.2 on openSUSE 15.3

[Ankalagon]

@JoeCFD

MyClass *mc = MyClass::instance();
qDebug() << mc->sampleFunc(1);

[Ankalagon]

Hm, strange. When I use qdoc-6 it works as intended. Maybe something is broken.