Qt World Summit: Submit your Presentation

Empty Assistant after building and installing Qt5

  • I'm building Qt5 for x64 platform with Visual Studio 2010 Professional on Windows 7. Everything seems just fine except that after building and installing the Qt Assistant application shows no contents. It just shows a single page and nothing more. How to deal with it? Where is the issue? I have searched long and far and nothing seems to help.

    Generally I'm building "out of source" in a structure that would allow in future to add paralel x32 version if there would be need for that. Here is my procedure:

    I'm unpacking "qt-everywhere-opensource-src-5.0.1.zip" into "C:\Qt\qt-everywhere-opensource-src-5.0.1\src".

    Then I'm making empty "C:\Qt\qt-everywhere-opensource-src-5.0.1\x64\bin" directory.

    From that directory I'm executing "build.cmd" (within "Visual Studio x64 Win64 Command Prompt (2010)"):

    @SET SRC=%CD%....\src

    SET INSTALL=%CD%..\install
    SET FIREBIRD=C:\Library\Firebird\Firebird-
    SET ICU=C:\BuildSystem\Libraries\ICU\icu4c-51_1-Win64-msvc10
    SET OPENSSL=C:\Library\OpenSSL-Win64

    SET PATH=%SRC%\qtbase\bin;%PATH%
    SET PATH=%SRC%\gnuwin32\bin;%PATH%
    SET PATH=%ICU%\bin64;%PATH%

    SET CL=/MP %CL%

    CALL %SRC%\configure -help > output-configure-help.txt 2>&1
    rmdir /S /Q qtbase

    CALL %SRC%\configure -prefix %INSTALL% -debug-and-release -opensource -confirm-license -c++11 -shared -ltcg -make libs -make tools -make examples -make docs -accessibility -plugin-sql-ibase -I "%FIREBIRD%\include" -L "%FIREBIRD%\lib" -opengl desktop -openvg -platform win32-msvc2010 -iconv -inotify -largefile -fontconfig -posix-ipc -qt-zlib -qt-pcre -icu -I "%ICU%\include" -L "%ICU%\lib64" -qt-libpng -qt-libjpeg -qt-freetype -angle -qmake -rtti -sse2 -sse3 -ssse3 -sse4.1 -sse4.2 -avx -avx2 -openssl -I "%OPENSSL%\include" -L "%OPENSSL%\lib\VC\static" -qml-debug -directwrite -qt-style-windows -qt-style-windowsxp -qt-style-windowsvista -qt-style-fusion -qt-style-windowsce -qt-style-windowsmobile -native-gestures -mp > output-configure.txt 2>&1

    nmake > output-nmake.txt 2>&1

    nmake install > output-nmake-install.txt 2>&1@

    I can provide the output files if there is need but I doubt there would (while they are lengthy). It seems enough to say that no errors are reported and resulting "install" seems otherwise fine and working well.

    So how to make the Assistant show contents?

  • As I recall, you have to add the help documents. In the Edit menu, choose 'Preferences' and then the 'Documentation' tab. Click on the 'Add' button and navigate to the .qch files you want/need to add. On my system, they are located: C:\Qt-VS2010\4.8.2_win32\doc\qch

  • Indeed! Menu Edit | Settings... shows a dialog in which one of the tabs allows to add contents files.

    But the only *.qch files I have are:

    • linguist-3.3.8.qch (x2),
    • qmake-3.3.8.qch (x3),
    • qmake-4.3.0.qch (x3),
    • simpletextviewer.qch (x1),
    • test.qch (x3),
    • wateringmachine.qch (x1),
    • assistant.qch (x1),

    all located in subdirectories of "src" directorty which means they were not build but within the distribution itself.

  • Lifetime Qt Champion


    Try to run nmake docs, this should build the documentation

Log in to reply