[Development] Failed to build Qt6 Documentation from qt/qtbase sources?

[Ahmad Samir]

On 1/8/23 15:22, Haowei Hsu wrote:
> Hello, Qt Development Team.
> 
> Recently, I tried to build the Qt6 Documentation from qt/qtbase
> <https://github.com/qt/qtbase> sources. In order to
> build Qt6 Documentation more conveniently, I prepared a
> *CMakeUserPresets.json*
> in the root directory with some required configurations introduced in:
> 
>     - Building Qt Documentation - Qt Wiki
>     <https://wiki.qt.io/Building_Qt_Documentation#Building_Qt_6_Documentation>
>     - Qt Build System Glossary - Qt Wiki
>     <https://wiki.qt.io/Qt_Build_System_Glossary#Documentation-only_Build>
> 
> The following is the content of my *CMakeUserPresets.json*:
> 
> {
>    "version": 4,
>    "cmakeMinimumRequired": {
>      "major": 3,
>      "minor": 23,
>      "patch": 0
>    },
>    "configurePresets": [
>      {
>        "name": "win32",
>        "description": "Windows",
>        "binaryDir": "${sourceDir}/build/${presetName}",
>        "generator": "Ninja",
>        "toolset": {
>          "value": "v142,host=x64",
>          "strategy": "external"
>        },
>        "architecture": {
>          "value": "x64",
>          "strategy": "external"
>        },
>        "cacheVariables": {
>          "CMAKE_C_COMPILER": "cl.exe",
>          "CMAKE_CXX_COMPILER": "cl.exe",
>          "QT_HOST_PATH": "C:/Qt/6.3.2/msvc2019_64",
>          "QT_NO_PACKAGE_VERSION_CHECK": true
>        },
>        "environment": {
>          "LLVM_INSTALL_DIR": "C:\\Program Files\\LLVM"
>        }
>      }
>    ]
> }
> 
> The followings are the steps I used to build *docs_Core* target
> 
>     1. Run: *git clone https://github.com/qt/qtbase.git
>     <https://github.com/qt/qtbase.git>*
>     2. Run: *cd qtbase*
>     3. Run: *git checkout 6.5*
>     4. Add the above custom *CMakeUserPresets.json*
>     5. Run: *vcvarsall.bat x64*
>     6. Run: *cmake --preset win32*
>     7. Run: *cmake --build build/win32 --target docs_Core*
> 
> However, it turns out that there is an error in the Step 7:
> 
> [image: image.png]
> 
> What happened? What did I miss? Can you help me to figure out this problem?
> 
> You can see the attachment with the full log: *log-build-qt6-docs.txt*
> ---
> Haowei Hsu
> 
> 

 From the build log:
D:/Repo/GitHub/testing/qtbase/src/corelib/doc/qtcore.qdocconf:1: (qdoc) error: 
Cannot open file 'C:/Qt/Qt-6.5.3/./doc/global/qt-module-defaults.qdocconf': 
???????????
Cannot open file 'C:/Qt/Qt-6.5.3/./doc/global/qt-module-defaults.qdocconf': 
???????????


I don't use Windows so I am not sure how this can be fixed; it's looking for the 
.qdocconf file in the installation path rather than the source dir (in the git 
checkout).

Regards
Ahmad Samir

-------------- next part --------------
A non-text attachment was scrubbed...
Name: OpenPGP_signature
Type: application/pgp-signature
Size: 236 bytes
Desc: OpenPGP digital signature
URL: <http://lists.qt-project.org/pipermail/development/attachments/20230803/1db7ec59/attachment.sig>