Running QDoc out of Qt's source tree

[kshegunov]

How can I run qdoc out of Qt's source? I can build the Qt docs fine, but somehow I can't get to configure the paths and includes (e.g. compat.qdocconf) in a reasonable way. The only thing I could think of is to hardcode the paths, which is iffy at best.

The qdoc manual treats syntax and configuration files extensively, but covers next to nothing on how to use the tool.

[SGaist]

Hi,

Do you need this for a custom Qt module or for a classic project ?

[kshegunov]

@SGaist
A classic project; it's for my daemon library. If qdoc can't be used that way, I could switch to doxygen, but I wanted to give it a try first.

[SGaist]

Would you like that library to be usable like a Qt module ?

[kshegunov]

@SGaist
Hi,

What's the difference between a Qt module and plain ol' dynamic library?
If you're asking if I'm interfacing against the private API, then no, I'm not. It's a standalone library.

[SGaist]

With a Qt module you can do something like

QT += daemon

like you would for e.g the Qt serial port module.

[kshegunov]

@SGaist
No, I don't intend to do that, at least not at this stage. For now it's a simple library that you link and include by yourself.

[SGaist]

The technique was to use a qdoc configuration file and load the appropriate Qt features.

In the end, the library was converted to a Qt module.