Getting Qt docs built and installed on Windows



  • I've followed the instructions "here":http://qt-project.org/wiki/Building_Qt_Documentation for how to build the documentation. It doesn't work at all. The config.summary file (shown below) shows the location for the doc folder. It only contains a global folder. However the doc folder in qtbase contains what appears to be all the .qch files. The html files are created also in qtbase\qdoc bot also not installed.

    @
    Environment:
    INCLUDE=
    C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\INCLUDE
    C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\ATLMFC\INCLUDE
    C:\Program Files (x86)\Windows Kits\8.0\include\shared
    C:\Program Files (x86)\Windows Kits\8.0\include\um
    C:\Program Files (x86)\Windows Kits\8.0\include\winrt

    LIB=
      C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\LIB
      C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\ATLMFC\LIB
      C:\Program Files (x86)\Windows Kits\8.0\lib\win8\um\x86
      
    PATH=
      C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\CommonExtensions\Microsoft\TestWindow
      C:\Program Files (x86)\Microsoft SDKs\F#\3.0\Framework\v4.0\
      C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\
      C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\BIN
      C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\Tools
      C:\Windows\Microsoft.NET\Framework\v4.0.30319
      C:\Windows\Microsoft.NET\Framework\v3.5
      C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\VCPackages
      C:\Program Files (x86)\HTML Help Workshop
      C:\Program Files (x86)\Microsoft Visual Studio 11.0\Team Tools\Performance Tools
      C:\Program Files (x86)\Windows Kits\8.0\bin\x86
      C:\Program Files (x86)\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools
      C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0A\Bin\
      C:\Python33\
      C:\Perl64\site\bin
      C:\Perl64\bin
      C:\Windows\system32
      C:\Windows
      C:\Windows\System32\Wbem
      C:\Windows\System32\WindowsPowerShell\v1.0\
      c:\Program Files (x86)\Microsoft SQL Server\100\Tools\Binn\
      c:\Program Files\Microsoft SQL Server\100\Tools\Binn\
      c:\Program Files\Microsoft SQL Server\100\DTS\Binn\
      C:\Program Files\Microsoft Windows Performance Toolkit\
      C:\Program Files\TortoiseSVN\bin
      C:\Program Files (x86)\Windows Kits\8.0\Windows Performance Toolkit\
      C:\Program Files\Microsoft SQL Server\110\Tools\Binn\
      C:\Program Files (x86)\Git\cmd
      C:\Program Files (x86)\Git\bin
      C:\Qt\jom
      c:\tools
    

    Configuration:
    minimal-config
    small-config
    medium-config
    large-config
    full-config
    pcre
    debug
    compile_examples
    msvc_mp
    Qt Configuration:
    debug_and_release build_all release
    debug
    shared
    zlib
    png
    freetype
    build_all
    accessibility
    opengl
    audio-backend
    wmf-backend
    native-gestures
    qpa
    concurrent
    minimal-config
    small-config
    medium-config
    large-config
    full-config

    QMAKESPEC...................win32-msvc2012 (commandline)
    Architecture................i386, features: sse sse2
    Host Architecture...........i386, features: sse sse2
    Maketool....................nmake
    Debug build.................yes (combined)
    Default build...............debug
    Force debug info............no
    C++11 support...............auto
    Link Time Code Generation...no
    Accessibility support.......yes
    RTTI support................yes
    SSE2 support................yes
    SSE3 support................yes
    SSSE3 support...............yes
    SSE4.1 support..............yes
    SSE4.2 support..............yes
    AVX support.................yes
    AVX2 support................yes
    NEON support................no
    IWMMXT support..............no
    OpenGL support..............yes
    Large File support..........yes
    NIS support.................no
    Iconv support...............no
    Inotify support.............no
    eventfd(7) support..........no
    Glib support................no
    CUPS support................no
    OpenVG support..............no
    OpenSSL support.............no
    Qt D-Bus support............no
    Qt Widgets module support...yes
    Qt GUI module support.......yes
    QML debugging...............yes
    DirectWrite support.........no
    Use system proxies..........no

    Third Party Libraries:
    ZLIB support............qt
    GIF support.............plugin
    JPEG support............plugin
    PNG support.............yes
    FreeType support........yes

    PCRE support............qt
    ICU support.............no
    ANGLE...................no
    

    Styles:
    Windows.................yes
    Windows XP..............yes
    Windows Vista...........yes
    Fusion..................yes
    Windows CE..............no
    Windows Mobile..........no

    Sql Drivers:
    ODBC....................no
    MySQL...................no
    OCI.....................no
    PostgreSQL..............no
    TDS.....................no
    DB2.....................no
    SQLite..................plugin (qt)
    SQLite2.................no
    InterBase...............no

    Sources are in..............C:\Qt\qt5\qtbase
    Build is done in............C:\Qt\qt5\qtbase
    Install prefix..............c:\Qt\5.1.1\msvc2012
    Headers installed to........c:\Qt\5.1.1\msvc2012\include
    Libraries installed to......c:\Qt\5.1.1\msvc2012\lib
    Arch-dep. data to...........c:\Qt\5.1.1\msvc2012
    Plugins installed to........c:\Qt\5.1.1\msvc2012\plugins
    Library execs installed to..c:\Qt\5.1.1\msvc2012\bin
    QML1 imports installed to...c:\Qt\5.1.1\msvc2012\imports
    QML2 imports installed to...c:\Qt\5.1.1\msvc2012\qml
    Binaries installed to.......c:\Qt\5.1.1\msvc2012\bin
    Arch-indep. data to.........c:\Qt\5.1.1\msvc2012
    Docs installed to...........c:\Qt\5.1.1\msvc2012\doc
    Translations installed to...c:\Qt\5.1.1\msvc2012\translations
    Examples installed to.......c:\Qt\5.1.1\msvc2012\examples
    Tests installed to..........c:\Qt\5.1.1\msvc2012\tests

    @

    Please help.


  • Lifetime Qt Champion

    Hi,

    Did you call nmake install once you built the doc ?



  • Yes I did. Let me clarify though. I called nmake install from within the root of the source tree i.e. qt5. That is, I performed config, jom -j 4 (nmake) and then jom -j 4 install. That was ncessesary to build then install the target folders, and its contents and it all worked too except for docs.

    Hope that helps



  • I have tried again building tag v5.1.1 from scratch and AGAIN it fails to install. Note that I specify an install folder using the -prefix option with configure and it is reflected in the output of qmake -query. When I build the docs I get numerous "cannot find index directory" messages. There is no bug for this version but there IS a largely commented bug for v5.02 and it remains unresolved.

    Will someone please help? Is it wrong to specify an alternate install directory? Everything installs for the build except the docs. I'm surprised there haven't been more attention paid to this problem


  • Lifetime Qt Champion

    I don't think it's fundamentally wrong, but the "instructions":http://qt-project.org/doc/qt-5.0/qtdoc/install-win.html for windows are to build "in place" and not install. So the question is: are you bitten by that ?



  • Hi,
    Well the instructions pointed to leave out a step that suggests that the docs are a separate effort than the rest of the build as I pointed out at the top of my post. The only distinction regarding Windows is in nmake versus make. The doc build instructions DO state that qtbase be built AND installed. I don't know how else to interpret that.

    I am "bitten" by the inconsistency of one set of instructions versus the other. Additionally, are you suggesting that for Windows the build is local to the root of the checked out source tree i.e. qt5, and then to use that folder structure? For example, the bin folder living in c:\qt5\qtbase\bin versus mine - c:\qt\5.1.1\msvc2012\bin. The latter (c:\qt\5.1.1\msvc2012) is what I used as a prefix.


  • Lifetime Qt Champion

    Which instructions are you referring to ?



  • [quote author="SGaist" date="1380124933"]Which instructions are you referring to ?[/quote]

    Your instructions posted moments ago versus mine - at the top.


  • Lifetime Qt Champion

    No it's not local to it, you can have an out of source build without any problem



  • [quote author="SGaist" date="1380664652"]No it's not local to it, you can have an out of source build without any problem[/quote]

    What's meant by out of source?


  • Lifetime Qt Champion

    \Qt
    \Qt\qtsources
    \Qt\build_qt <- call ..\qtsources\configure and nmake here



  • Could be me but I don't see the context of what you wrote. I posted the paths that I have used to try and rebuild from source.

    Thanks anyway


  • Lifetime Qt Champion

    From your configure log, you are building directly in the source tree and installing in a prefixed folder. An out of source build occurs in another folder so could directly configure/build in c:\Qt\5.1.1\msvc2012 without using a prefix



  • The path "c:\Qt\5.1.1\msvc2012" is a target path; it's created upon the install target. i.e. nmake install. Are you suggesting renaming the source tree to the target path? If true, how is that not then building in the source tree?


  • Lifetime Qt Champion

    No, that's not what i am suggesting:

    @cd c:\Qt\5.1.1\msvc2012
    C:\Qt\qt5\qtbase\configure
    nmake@

    No need of a prefix nor install



  • [quote author="SGaist" date="1380747770"]No, that's not what i am suggesting:

    @cd c:\Qt\5.1.1\msvc2012
    C:\Qt\qt5\qtbase\configure
    nmake@

    No need of a prefix nor install[/quote]

    The folder msvc2012 is, as I metnioned earlier a target folder. It is created from the install target of make (nmake). If I created that folder and called configure from its location, what causes configure or nmake to install binaries to the folder I created?

    EDIT:
    So I tried what you suggested. Take note that the first response to my post was if I called nmake install. WIth that aside, I was successful in getting the binaries installed to the bin folder of the folder I created:

    @
    cd C:\Qt\5.1.1msvc2012
    z:\qt5\qtbase\configure ..........
    jom -j4
    @

    I STILL get no docs created from my "out of source build"


Log in to reply
 

Looks like your connection to Qt Forum was lost, please wait while we try to reconnect.