最近，Qt 版本 5.11 发布了，变更内容可以看这里。我也花了点时间下载编译了一回。原本以为只是一个小版本的变更，对于已经多次自己编译过 Qt 的我来说应该是轻车熟路（当然编译花费的时间依旧漫长）。没想到的是，主体程序的编译虽然很顺利，但编译文档时却出错了，提示 qdoc 不是合法的命令。到程序目录下面看，确实没有生成 qdoc.exe。

这是怎么回事？到官方网站上查找，发现这样的内容：

Note: From Qt 5.11, QDoc requires clang from LLVM 3.9 for parsing C++ header and source files, and for parsing the function signatures in \fn commands. See Installing clang for QDoc for details.

原来编译文档现在需要 LLVM/CLang 了。按照官方描述的信息，下载 并安装 LLVM 当前版本，并设置 LLVM_INSTALL_DIR 环境变量到安装目录，然后再重新编译。在失败的目录上重新编译似乎是不行的，最好是删除原来的内容，配置好环境后，再整个重新编译。

再次经历漫长的编译时间，这次一切正常，qdoc 和所有 .qch 文件全部生成成功。