Details
-
Bug
-
Resolution: Done
-
P1: Critical
-
5.11.0 Alpha
-
None
Description
I've recently updated my dev branch of qt and I have big issues compiling qdoc. For the first machine I've learned (from a colleague) that I need libclang in order to compile it. So, the first issue is:
1. No info that I need libclang.
OK, so I wanted to install it on fedora. dnf doesn't know the "libclang", and googling didn't give me any results for "libclang". In meantime I've installed clang and many other packages with "clang" or "llvm" in its name. Still I couldn't compile it. The colleague said the ./configure should say anything about missing libclang in order to compile qdoc, however configure didn't give any info about it. So:
2. ./configure should mention about a new dependency
Again, the colleague pointed me to https://download.qt.io/development_releases/prebuilt/libclang/ - it's very hard to find this particular package if you don't know the direct link. So:
3. We should mention this link in e.g. https://wiki.qt.io/Building_Qt_5_from_Git
OK, I've downloaded the package and... what? What should I do with it? This is prebuild package, so... I don't want to copy the libs, headers and includes manually to some system location... So, again, the colleagure said I should set the LLVM_INSTALL_DIR env var. OK, I wouldn't guess its name easily. The name is misleading, taking into account I need a libclang and I need to set llvm var. So:
4. We should descibe the LLVM_INSTALL_DIR var.
So, finally I could compile the qdoc on one machine. I have another machine and wanted to set the same env. So, I downloaded the package, unpacked it, set the env var and... it didn't work. Moreover, the stuff from the package collides with some system libs (version mismatch) when I was trying to compile QtCreator. I had to unset the LLVM_INSTALL_DIR in order to compile creator. Still, I don't know how to set properly the env on the second machine.
So, the new qdoc dependency is already merged to dev branch. It means much more users will have the above issues soon. I'm a bit surprised that we force the user to install a package which isn't easily accessible (e.g. through fedora dnf), so I expect this is currently a temporary situation which is going to change soon, isn't it? Anyway, it would be really cool to describe somewhere the setup process properly.
New facts: looks like I need also "ghdl-llvm-grt" package installed - this helped in case of the second machine. So:
5. Describe, that you need "ghdl-llvm-grt" package
Attachments
Issue Links
- depends on
-
QTBUG-66405 configure should ensure that qdoc's clang dependency is met
- Closed
- is duplicated by
-
QTBUG-69225 Building Qt v5.11.x Documentation Fails on OS X/macOS Under Homebrew
- Closed
- is required for
-
QTBUG-66015 Regression[5.10 -> 5.11]: released qdoc binary does not run on Linux and Windows nor macOS
- Closed
-
QTBUG-67669 page not found: qt3dcore/index.html
- Closed
-
QTBUG-67670 Assistant does not load page when different page is missing
- Closed
- relates to
-
QTBUG-69224 qdoc tool is not generated during Qt installation via source files
- Closed
-
QTBUG-67189 qdoc doesn't use clang from standard paths
- Closed
-
QTBUG-70969 qttools won't build without clang
- Closed
-
QTBUG-70486 qdoc.exe is not building during qtbase
- Closed
-
QTBUG-68410 qdoc is not built on GCC/Linux and MinGW/Windows
- Closed
-
QTBUG-69791 WIN64: 'cannot find -llibclang' error for static builds using mingw-w64
- Closed
-
QTBUG-68477 debian stretch cannot build qdoc even with llvm-3.9-dev and clang.3.9-dev installed
- Closed
-
QTBUG-66353 Document LLVM dependency of qdoc
- Closed
- resulted in
-
QTBUG-72259 Add section to Config Summary about QDoc
- Closed
For Gerrit Dashboard: QTBUG-65762 | ||||||
---|---|---|---|---|---|---|
# | Subject | Branch | Project | Status | CR | V |
220156,2 | doc: Warn users about qdoc's clang dependency | 5.11 | qt/qtdoc | Status: MERGED | +2 | 0 |
220480,7 | doc: Add short page users about qdoc's clang dependency | 5.11 | qt/qttools | Status: MERGED | +2 | 0 |
231493,4 | qdoc: use homebrew llvm by default | dev | qt/qttools | Status: MERGED | +2 | 0 |
238403,2 | Doc: Extend description of Clang dependency for QDoc | 5.11.2 | qt/qttools | Status: MERGED | +2 | 0 |
238410,2 | Doc: Add QDoc's Clang dependency info to platform requirement pages | 5.11.2 | qt/qtdoc | Status: MERGED | +2 | 0 |
248175,9 | Try multiple llvm-config candidates when configuring QDoc | 5.12.1 | qt/qttools | Status: MERGED | +2 | 0 |