Details
-
Bug
-
Resolution: Done
-
P3: Somewhat important
-
5.4.0
-
None
-
01d5c773894604fa840247f23a3388cb5cf599d9
Description
qdoc is supposed to write Doxygen-compatible tag files (e.g. qtcore.tags) as part of the build process. All project files in the Qt source use a relative path such as ../../../doc/$module/$module.tags. When doing an out-of-source build the tag files are never written and there's no indication why anything would've failed. The reason is that the function responsible for opening the tag file for writing, QDocTagFiles::generateTagFile, silently returns when the file can't be opened. In addition the tag file path is relative to the source directory, not the build directory, and the referenced directory does not exist.
This means there are two separate, albeit connected, issues:
- Non-existent error handling in QDocTagFiles::generateTagFile makes diagnosis much harder
- Tag file path in qdocconf files should be relative to build directory
Attachments
Issue Links
- is duplicated by
-
QTBUG-43033 Broken links/Assistant TOC entries in documentation in dev branch (5.5) as of 2.12.2014
- Closed