[[PageOutline]]
= Build Instructions for the QtWebKit build on Windows =

== Dependencies ==

First of all you need a version of Qt for Windows. If you are an Open Source developer then you can for example download the Open Source Edition of Qt for Windows from the Trolltech Website: [http://trolltech.com/developer/downloads/qt/windows]

The following external GNU tools are needed from the [http://gnuwin32.sourceforge.net/packages.html GnuWin32 Project]:

 * Make
 * Bison
 * Gperf
 * Flex
 * LibIconv (needed for bison)

In addition you need Perl. ActiveState Perl works fine for example. You can download it from the [http://www.activestate.com/Products/ActivePerl/ ActivePerl Website].

Make sure the GnuWin32 packages are in your PATH as well as Perl. You also need to have %QTDIR% set and have %QTDIR%\bin in your PATH.

Please note that building inside Cygwin is currently not supported.

== Building QtWebKit ==

 * Open for example a Qt Command Prompt from the Start Menu
 * Change into the WebKit source tree
 * Run {{{perl WebKitTools\Scripts\build-webkit --qt}}}
 * Wait :)
 * {{{build-webkit}}} is likely to abort with an error when compiling testkjs if you're compiling with MingW g++. This is '''safe''' to ignore for now.
 * Try to run WebKitBuild\Release\bin\QtLauncher.exe

=== Notes about building QtWebKit with the Qt/Windows OpenSource Edition ===

 * Make sure that you are using Qt >= 4.3.2. Otherwise you may run into build problems with the Moc at the very end of the build process.
 * If you haven't set up your PATH already to include the GnuWin32 packages then you may want to execute the following command: {{{set PATH=C:\GnuWin32\bin;C:\Perl\bin;%PATH%}}} Provided that the GnuWin32 packages are installed in {{{C:\GnuWin32\bin}}} and Perl in {{{C:\Perl\bin}}}.
 * If you get build errors in JavaScriptCore\bindings\NP_jsobject.cpp or similar then please make sure that the Microsoft Platform SDK is '''NOT''' in your %INCLUDE% path because it conflicts with your MingW headers.
 * If you get build errors after makefile generation ("Makefile:178: *** Multiple target patterns.  Stop.") then you're probably still using the Cygwin version of make. Try removing Cygwin from your %PATH% for the time being (it's not currently supported, as mentioned above).
 * I had troubles with m4 when the GnuWin32 packages were installed in C:\Program Files\GnuWin32 (something choked on the whitespace), it worked when installing them into C:\GnuWin32 instead.

* When I try to build using Qt 4.4.3 on windows, the above procedure throws error. all the build (perl) scripts are using unix style dir-paths. Example buildQMakeProject perl method in webkitdirs.pm uses unix style dir-path and also reading pro file. I am amazing that the people could build Qt port of Webkit on Windows.
Please Let me know exact steps / modification required to build the Webkit in Qt command prompt.