[Development] Failed to run configure.bat in qt/qt5 repository on Windows?

Thu Aug 17 10:28:17 CEST 2023

Hi,

In documentation that you linked, it's written that you will need qdoc, qtattributionsscanner and possibly qhelpgenerator.
so running 
$ ninja qdoc qtattributionsscanner qhelpgenerator.
should hopefully be sufficient

> On 17. Aug 2023, at 10:17, Haowei Hsu <hwhsu1231 at gmail.com> wrote:
> 
> Hello, Alexandru. Thank you for your reply. In that case, I have another question to ask:
>     • 
> Which module should I build before building the Qt documentation?
> Since I only want to build the Qt documentation, I hope to minimize other unnecessary build 
> steps. According to the Qt Wiki, if I want to build the Qt documentation, I need to have the 
> QDoc executable ready, which seems to be a submodule in the qt/qttools repository. So,
>     • 
> Do I just need to build the 'qdoc' target in the 'qttools' repository?
> <image.png>
> 
> ---
> Haowei Hsu
> 
> Alexandru Croitor <alexandru.croitor at qt.io> 於 2023年8月17日 週四 下午3:50寫道：
> Hi,
> 
> You can't use Qt 6.3.2 to build documentation of Qt 6.5 / 6.6 / 6.7 / dev. Mixing versions like that is not supported.
> The configure log even tells you that, but you passed -DQT_NO_PACKAGE_VERSION_CHECK=TRUE anyway.
> 
> You need a Qt 6.5 build to build documentation for Qt 6.5.
> You need a Qt 6.6 build to build documentation for Qt 6.6.
> You need a dev branch Qt build to build documentation for Qt dev branch
> Etc.
> 
> Anything else is unsupported and you are on your own.
> 
> Regarding the second case failure, you're trying to configure both qtpositioning and qtlocation. 
> I suggest you remove the sources of either one or the other, or pass -skip qtpositioning or -skip qtlocation to configure.
> 
> 
> > On 17. Aug 2023, at 09:33, Haowei Hsu <hwhsu1231 at gmail.com> wrote:
> > 
> > Hello, Qt Development Team.
> > After running:
> >     • git clean -xfdf && git submodule foreach --recursive git clean -xfdf
> >     • git submodule update --recursive
> > the worktree is clean comprehensively.
> > However, there is another error when configuring the project.
> > 
> > <image.png>
> > 
> > The following cases are what I use to test:
> > 
> > Case 1: Failed to configure.bat the 'dev' branch
> > 
> > The following commands are what I run:
> >     • git clone --recursive https://github.com/qt/qt5.git qt
> >     • chdir qt
> >     • mkdir build && chdir build
> >     • vcvarsall.bat x64
> >     • ..\configure.bat -developer-build -- -DQT_HOST_PATH="C:/Qt/6.3.2/msvc2019_64" -DQT_NO_PACKAGE_VERSION_CHECK=TRUE
> > You can see the attachment with the full log: log-case-1-git-clone-but-failed-to-configure-dev-branch.txt
> > 
> > Case 2: Failed to configure.bat the '6.3' branch
> > 
> > The following commands are what I run:
> >     • 
> > chdir ..
> >     • git checkout 6.3
> >     • rmdir /s/q build
> >     • git clean -xfdf && git submodule foreach --recursive git clean -xfdf
> >     • git submodule update --recursive
> >     • git status
> >     • mkdir build && chdir build
> >     • ..\configure.bat -developer-build -- -DQT_HOST_PATH="C:/Qt/6.3.2/msvc2019_64" -DQT_NO_PACKAGE_VERSION_CHECK=TRUE
> > You can see the attachment with the full log: log-case-2-failed-to-configure-6.3-branch.txt
> > 
> > Case 3: Failed to configure.bat the '6.5' branch
> > 
> > The following commands are what I run:
> >     • 
> > chdir ..
> >     • git checkout 6.5
> >     • rmdir /s/q build
> >     • git clean -xfdf && git submodule foreach --recursive git clean -xfdf
> >     • git submodule update --recursive
> >     • git status
> >     • mkdir build && chdir build
> >     • ..\configure.bat -developer-build -- -DQT_HOST_PATH="C:/Qt/6.3.2/msvc2019_64" -DQT_NO_PACKAGE_VERSION_CHECK=TRUE
> > 
> > You can see the attachment with the full log: log-case-3-failed-to-configure-6.5-branch.txt
> > 
> > ---
> > Haowei Hsu
> > 
> > Haowei Hsu <hwhsu1231 at gmail.com> 於 2023年8月15日 週二 下午2:51寫道：
> > Hello, Alexey.
> > About your previous comments:
> > 
> > Calling 'git clean -xdf' as step 5b should remove those leftovers. 
> > 
> > and
> >  From the log it's clear that qtgraphs has the newer version than the qtbase and other repos. I'm not sure why cleaning qt5 repo didn't help.
> > 
> > I think I found the solution to how to remove those untracked submodules properly. That is:
> > 
> > git clean -xfdf
> > 
> > This command is found at: https://stackoverflow.com/a/52044955/16265240
> > The following commands are what I test:
> >     • 
> > git status
> >     • git checkout v6.3.2
> >     • git status
> >     • git clean -xfdf
> >     • git status
> > <image.png>
> > 
> > 
> > You can see the attachment with the full log: log-git-clean-xfdf-after-checkout.txt
> > ---
> > Haowei Hsu
> > 
> > Alexey Edelev <alexey.edelev at qt.io> 於 2023年8月14日 週一 上午1:00寫道：
> > Hi Haowei Hsu,
> > 
> > From the log it's clear that qtgraphs has the newer version than the qtbase and other repos. I'm not sure why cleaning qt5 repo didn't help.
> > 
> > Try remove the 'qtgraphs' directory manually to make sure it's not included into top-level qt configuring process. You also may try to add '-skip qtgraphs' argument to the '..\configure' command. If the issue occurs again with other repo, do the same.
> > 
> > Regards,
> > Alexey
> > 
> > Alexey Edelev
> > Software EngineerQt Group
> > Erich-Thilo-Str. 10 12489
> > Berlin, Germany
> > alexey.edelev at qt.io
> > www.qt.ioFrom: Haowei Hsu <hwhsu1231 at gmail.com>
> > Sent: Sunday, August 13, 2023 6:47 PM
> > To: Alexey Edelev <alexey.edelev at qt.io>
> > Cc: Qt development mailing list <development at qt-project.org>
> > Subject: Re: [Development] Failed to run configure.bat in qt/qt5 repository on Windows?
> >  Hello, Alexey. 
> > Thanks for your reply. However, even though I run 'git clean -xdf' before '..\configure.bat',
> > the error still showed up. The following commands are what I tried:
> >     • 
> > rmdir /s/q build
> >     • git status
> >     • git clean -xdf
> >     • git submodule update --recursive
> >     • mkdir build && chdir build
> >     • ..\configure.bat
> > 
> > What happened?
> > You can see the attachment with the full log: log-failed-even-after-git-clean-xdf.txt
> > ---
> > Haowei Hsu
> > 
> > Alexey Edelev <alexey.edelev at qt.io> 於 2023年8月13日 週日 下午8:27寫道：
> > Hi Haowei Hsu,
> > you cloned the full Qt repo recursively at first step, so some modules that are only available in 'dev', such as qtgraphs were cloned too. After you checked out v 6.5.2 those repos remain on file system as free-floating sources without version control. 
> > Calling 'git clean -xdf' as step 5b should remove those leftovers.
> > 
> > The error that you see means that some modules have incompatible version, so the root cause of this behavior I described above.
> > 
> > Regards,
> > Alexey
> > 
> > 
> > 
> > 
> > Alexey Edelev
> > Software Engineer
> > 
> > 
> > Qt Group
> > Erich-Thilo-Str. 10 12489
> > Berlin, Germany
> > alexey.edelev at qt.io
> > www.qt.io
> > 
> > 
> > 
> > 
> > 
> > From: Development <development-bounces at qt-project.org> on behalf of Haowei Hsu <hwhsu1231 at gmail.com>
> > Sent: Sunday, August 13, 2023 2:08 PM
> > To: Qt development mailing list <development at qt-project.org>
> > Subject: [Development] Failed to run configure.bat in qt/qt5 repository on Windows?
> >  Hello, Qt Development Team.
> > 
> > Recently, I tried to configure the qt/qt5 repository. The following commands
> > are what I use to configure the project according to its README.md:
> >     • 
> > git clone --recursive https://github.com/qt/qt5.git
> >     • chdir qt5
> >     • git status
> >     • git checkout v6.5.2
> >     • git submodule update --recursive
> >     • vcvarsall.bat x64
> >     • configure.bat
> > 
> > However, it turns out that there are some errors occurred. 
> > What do I miss? How to fix these errors?
> > 
> > <image.png>
> > 
> > NOTE: Currently, I just want to build Qt's Documentation instead of the 
> > whole Qt's artifacts.
> > 
> > You can see the attachment with the full log: log-failed-to-run-configure-on-windows.txt
> > ---
> > Haowei Hsu<log-case-2-failed-to-configure-6.3-branch.txt><log-case-3-failed-to-configure-6.5.branch.txt><log-case-1-git-clone-but-failed-to-configure-dev-branch.txt>-- 
> > Development mailing list
> > Development at qt-project.org
> > https://lists.qt-project.org/listinfo/development
> 
> 