Quote Originally Posted by Coises View Post
I presume the right way to generate Qt-like documentation is to use Doxygen? At least, the documentation comments in Qt source files sure look like Doxygen documentation, and Doxygen can generate *.qch files if you tell it where to find qhelpgenerator.exe.
There is no single "right way". Doxygen was created to mimic Trolltech's internal documenting tool and it's the suggested tool to be used for generating documentation. But certainly not the only one.

Assuming Doxygen is the way to go, are there style sheet and layout files to be found that generate documentation which roughly matches the look of the built-in Qt documentation?
None that I know of. I have a XSL template which makes it possible to convert xml output from doxygen to something that looks similar to official Qt docs but as I don't use doxygen anymore, the stylesheet is not maintained.

It would appear that I should be able to link transparently to the built-in Qt documentation, but I can’t figure out what I have to do to make that work.
I'm not sure if linking to the official docs is possible using doxygen as doxygen uses a different name mangling scheme than the official docs. In theory you would do it using a tag file created i.e. using ctags.

Assuming I get all that working... is there a straightforward way to add a Doxygen step to the build process, so that generating updated documentation becomes automatic whenever I rebuild?
Yes, that's more or less doable. Either use QMAKE_EXTRA_TARGETS or QMAKE_POSTTARGET_DEPS or something like that.