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\winrtLIB= 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-configQMAKESPEC...................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..........noThird Party Libraries:
ZLIB support............qt
GIF support.............plugin
JPEG support............plugin
PNG support.............yes
FreeType support........yesPCRE support............qt ICU support.............no ANGLE...................no
Styles:
Windows.................yes
Windows XP..............yes
Windows Vista...........yes
Fusion..................yes
Windows CE..............no
Windows Mobile..........noSql Drivers:
ODBC....................no
MySQL...................no
OCI.....................no
PostgreSQL..............no
TDS.....................no
DB2.....................no
SQLite..................plugin (qt)
SQLite2.................no
InterBase...............noSources 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.
-
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
-
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.
-
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.
-
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?
-
\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
-
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?
-
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"