#At file:///net/helheim/store/bteam/bzr/mysql-bug57746-5.5/ based on revid:sunanda.menon@stripped
3118 smenon 2010-11-04
Bug #57746: Win directory of source distribution - out-of-date files / support for new files
(win/README updated with some more changes)
=== modified file 'win/README'
--- a/win/README 2010-11-03 08:59:11 +0000
+++ b/win/README 2010-11-04 10:11:43 +0000
@@ -11,6 +11,7 @@ or ealier.
The Windows build system uses a tool named CMake to generate build files for
a variety of project systems. This tool is combined with a set of jscript
files to enable building of MySQL for Windows directly out of a bzr clone.
+For relevant information, please refer to http://forge.mysql.com/wiki/CMake
The steps required are below.
@@ -41,53 +42,42 @@ before you start the build)
-Clone your bzr tree to any location you like.
+One of the nice CMake features is "out-of-source" build support, which
+means not building in the source directory, but in dedicated build
+directory. This keeps the source directory clean and allows for more than
+single build tree for the same source tree (e.g debug and release, 32 and
+64 bit etc). We'll create subdirectory "bld" in the source directory for
+this purpose. Clone your bzr tree to any location you like.
-From the root of your installation directory, execute the command:
+From the root of your installation directory use cmake . -L to see the
+various configuration parameters.
-The options right now are:
- WITH_INNOBASE_STORAGE_ENGINE Enable particular storage engines
- __NT__ Enable named pipe support
- WITHOUT_ATOMICS Do not use atomic instructions
- MYSQL_SERVER_SUFFIX=<suffix> Server suffix, default none
- COMPILATION_COMMENT=<comment> Server comment, default "Source distribution"
- MYSQL_TCP_PORT=<port> Server port, default 3306
- CYBOZU Default character set is UTF8
- EMBED_MANIFESTS Embed custom manifests into final exes, otherwise VS
- default will be used. (Note - This option should only be
- used by MySQL AB.)
- WITH_EMBEDDED_SERVER Configure solution to produce libmysqld.dll
- and the static mysqlserver.lib
So the command line could look like:
-win\configure WITH_INNOBASE_STORAGE_ENGINE WITH_PARTITION_STORAGE_ENGINE MYSQL_SERVER_SUFFIX=-pro
+cmake .. -G "target" -DWITH_INNOBASE_STORAGE_ENGINE=1
+The recommended way of configuring would be to use -DBUILD_CONFIG=mysql_release
+to build binaries exactly the same as the official MySQL releases.
From the root of your installation directory/bzr clone, you can
-use cmake to compile the sources.Use cmake --help when necessary.
-Before you run cmake with changed settings (compiler, system
-libraries, options, ...), make sure you delete the CMakeCache.txt
-generated by your previous run.
+use cmake to compile the sources. Use cmake --help when necessary.
+Before you start building the sources, please remove the old build area
+created from an earlier run and start afresh.
+C:\> del bld
+C:\> md bld
+C:\> cd bld
+C:\> cmake .. -G "target name" -DBUILD_CONFIG=mysql_release
-C:\>cmake . -G "target name"
To generate the Win64 project files using Visual Studio 9, you would run
-cmake . -G "Visual Studio 9 2008 Win64"
+cmake .. -G "Visual Studio 9 2008 Win64"
Other target names supported using CMake 2.6 patch 4 are:
@@ -99,8 +89,8 @@ Other target names supported using CMake
For generating project files using Visual Studio 10, you need CMake 2.8
or higher and corresponding target names are
- Visual Studio 10
- Visual Studio 10 Win64
+ Visual Studio 10 "Visual Studio 10"
+ Visual Studio 10 (64 bit) "Visual Studio 10 Win64"
@@ -109,6 +99,10 @@ From the root of your bzr clone, start y
For Visual Studio, execute mysql.sln. This will start the IDE
and you can click the build solution menu option.
+Alternatively, you could start the build from command line as follows
+devenv mysql.sln /build relwithdebinfo
1. After changing configuration (eg. adding or removing a storage engine), it
Attachment: [text/bzr-bundle] email@example.com