Hi,
i currently try to use QDoc to generate documentation for a C++ project. I got it basically running, read the manual and got the basic concept, but there are a few things I am running in, that don't work as they should.

1. Linking doesnt work. I have a "\target abc" tag in one comment, and a "\l {abc} tag in another comment, and the qdoc.exe complains: "warning: Can't link to 'xyz'"

2. Inheritance doesn't work: I have some classes in C++ inheriting from one another. All classes a documented and somehow qdoc seems to notice, since it automatically creates a section "Inherits" onto the page of the class. But the section is empty, although there should be some classes in there (I did inherit as public, so that can't be the problem)

3. I cant use the \examples tag, although I did set the "exampledirs" variable in the qdocconf file. The qdoc.exe complains, that it can't find the file. But it definitely is there.


Here's the qdocconf I am using:
Qt Code:
  1. # QDoc is a tool that constantly evolves to suit our needs,
  2. # and there are some compatibility issues between old and new
  3. # practices. For that reason, any QDoc configuration file needs to
  4. # include compat.qdocconf.
  5.  
  6. #include(compat.qdocconf)
  7.  
  8. # The outputdir variable specifies the directory
  9. # where QDoc will put the generated documentation.
  10.  
  11. outputdir = html
  12.  
  13. # The headerdirs variable specifies the directories
  14. # containing the header files associated
  15. # with the .cpp source files used in the documentation.
  16.  
  17. headerdirs = ..
  18.  
  19. # The sourcedirs variable specifies the
  20. # directories containing the .cpp or .qdoc
  21. # files used in the documentation.
  22.  
  23. sourcedirs = .. \
  24. doc/src
  25.  
  26. # The exampledirs variable specifies the directories containing
  27. # the source code of the example files.
  28.  
  29. exampledirs = examples
  30.  
  31. # The imagedirs variable specifies the
  32. # directories containing the images used in the documentation.
  33. imagedirs = template\images
  34. images.fileextensions += "*.jpg *.png"
  35.  
  36. # The fileextensions specify, which files qdoc should scan
  37. # other files are just ignored.
  38. sources.fileextensions = "*.cpp *.qdoc *.mm *.qml"
  39. headers.fileextensions = "*.h *.ch *.h++ *.hh *.hpp *.hxx"
  40. examples.fileextensions = "*.cpp *.h *.js *.xq *.svg *.xml *.ui *.qhp *.qhcp *.qml"
  41. examples.imageextensions = "*.png *.jpeg *.jpg *.gif *.mng"
  42.  
  43. # Here some properties of the output HTML can be changes. For example a header and a footer
  44. # can be added to customize the output to your needs.
  45.  
  46. HTML.templatedir = template
  47. HTML.postheader = "<div id=\"postheader\" > <div id=\"logo\"><img src=\"images/logo.png\" /> </div> <h1> Frauenhofer CML - QDoc Project </h1> </div> "
  48. HTML.headerstyles = "<link rel=\"stylesheet\" type=\"text/css\" href=\"style/style.css\"/>"
To copy to clipboard, switch view to plain text mode 

Maybe you can point me on something that I might have to do additionally. Thanks already.