Update Visual C++ README.txt
[platform/upstream/glib.git] / build / win32 / vs10 / README.txt
1 Note that all this is rather experimental.
2
3 This VS10 solution and the projects it includes are intented to be used
4 in a GLib source tree unpacked from a tarball. In a git checkout you
5 first need to use some Unix-like environment or manual work to expand
6 the .in files needed, mainly config.h.win32.in into config.h.win32 and
7 glibconfig.h.win32.in into glibconfig.h.win32. You will also need to
8 expand the .vcprojin files here into .vcproj files.
9
10 The required dependencies are zlib and proxy-libintl. Fetch the latest
11 proxy-libintl-dev and zlib-dev zipfiles from
12 http://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ for 32-bit
13 builds, and correspondingly
14 http://ftp.gnome.org/pub/GNOME/binaries/win64/dependencies/ for 64-bit
15 builds.
16
17 One may wish to build his/her own ZLib-It is recommended that ZLib is
18 built using the win32/Makefile.msc makefile with VS10 with the ASM routines
19 to avoid linking problems-see win32/Makefile.msc in ZLib for more details.
20
21 One may optionally use his/her own PCRE installation by selecting the
22 (BuildType)_ExtPCRE configuration, but please note the PCRE must be built
23 with VS10 with unicode support using the /MD (release) or /MDd (debug)
24 runtime option which corresponds to your GLib build flavour (release, debug).
25 (These are the defaults set by CMAKE, which is used in recent versions of PCRE.)
26 Not doing so will most probably result in unexpected crashes in 
27 your programs due to the use of different CRTs.  If using a static PCRE
28 build, add PCRE_STATIC to the "preprocessor definitions".
29 Note that one may still continue to build with the bundled PCRE by selecting
30 the (BuildType) configuration.
31
32 Set up the source tree as follows under some arbitrary top
33 folder <root>:
34
35 <root>\<this-glib-source-tree>
36 <root>\vs10\<PlatformName>
37
38 *this* file you are now reading is thus located at
39 <root>\<this-glib-source-tree>\build\win32\vs10\README.
40
41 <PlatformName> is either Win32 or x64, as in VS10 project files.
42
43 You should unpack the proxy-libintl-dev zip file into
44 <root>\vs10\<PlatformName>, so that for instance libintl.h end up at
45 <root>\vs10\<PlatformName>\include\libintl.h.
46
47 The "install" project will copy build results and headers into their
48 appropriate location under <root>\vs10\<PlatformName>. For instance,
49 built DLLs go into <root>\vs10\<PlatformName>\bin, built LIBs into
50 <root>\vs10\<PlatformName>\lib and GLib headers into
51 <root>\vs10\<PlatformName>\include\glib-2.0. This is then from where
52 project files higher in the stack are supposed to look for them, not
53 from a specific GLib source tree.
54
55 --Tor Lillqvist <tml@iki.fi>
56 --Updated by Chun-wei Fan <fanc999@gmail.com>