Update VS README.txt's
[atk.git] / build / win32 / vs9 / README.txt
blob089e74ba9b6eefba3d84f2d61df53bdd38d9c03e
1 Please do not build this package in a path that contains spaces to avoid\r
2 possible problems during the build or during the usage of the library.\r
3 \r
4 This VS9 solution and the projects it includes are intented to be used\r
5 in a ATK source tree unpacked from a tarball. In a git checkout you\r
6 first need to use some Unix-like environment or manual work to expand\r
7 the .in files needed, mainly config.h.win32.in into config.h.win32.\r
8 You will also need to expand atk.vcprojin here into\r
9 atk.vcproj.\r
11 The dependencies for this package are gettext-runtime (libintl), GLib*\r
12 and ZLib.\r
14 a) look for all of the dependencies (except GLib*) under\r
16    http://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ (32-bit) -OR-\r
17    http://ftp.gnome.org/pub/GNOME/binaries/win64/dependencies/ (64-bit)\r
19    Please use the latest versions of these libraries that are available there,\r
20    these are packaged by Tor Lillqvist, which are built with MinGW/GCC.\r
21    Please see b) below regarding the build of  GLib*\r
23 -OR-\r
25 b) Build them yourself with VS9 (but you may most probably wish to get\r
26    gettext-runtime from the URL(s) mentioned in a)).  Use the latest\r
27    stable versions for them (you may need to get the latest unstable version of\r
28    GLib if you are using an unstable version of ATK):\r
30    GLib*:   Grab the latest sources from http://www.gtk.org under "Download"\r
31             (stable only-please make a search for the latest unstable versions)\r
32    ZLib:   http://www.zlib.net\r
34    The above 2 packages all have supported mechanisms (Makefiles and/or Project\r
35    Files) for building under VS9 (upgrade the Project Files from earlier VS\r
36    versions will do for these, when applicable)\r
38 * This GLib refers to a build that is built by VS9\r
40 Set up the source tree as follows under some arbitrary top\r
41 folder <root>:\r
43 <root>\atk\<this-atk-source-tree>\r
44 <root>\vs9\<PlatformName>\r
46 *this* file you are now reading is thus located at\r
47 <root>\atk\<this-atk-source-tree>\build\win32\vs9\README.\r
49 <PlatformName> is either Win32 or x64, as in VS9 project files.\r
51 You should unpack the <dependent-package>-dev and <dependent-packge> (runtime)\r
52 into <root>\vs9\<PlatformName>, if you download any of the packages from\r
54 http://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ (32-bit) -OR-\r
55 http://ftp.gnome.org/pub/GNOME/binaries/win64/dependencies/ (64-bit)\r
57 so that for instance libintl.h end up at \r
58 <root>\vs9\<PlatformName>\include\libintl.h.\r
60 If you build any of the dependencies yourselves, copy the: \r
61 -DLLs and EXEs into <root>\vs9\<PlatformName>\bin\r
62 -headers into <root>\vs9\<PlatformName>\include\\r
63 -LIBs into <root>\vs9\<PlatformName>\lib\r
65 If you have not built GLib with VS9 and placed the LIBs and headers in a\r
66 place where VS9 can find them automatically, you should also uncompress\r
67 your GLib sources in <root>\ and build it from there, following the\r
68 instructions in <root>\glib<-version>\build\win32\vs9, so that the required\r
69 headers, EXEs, DLLs and LIBs will end up in\r
70 <root>\vs9\<PlatformName>\include\glib-2.0 (headers)\r
71 <root>\vs9\<PlatformName>\lib (LIBs, also glib-2.0/include/glibocnfig.h)\r
72 <root>\vs9\<PlatformName>\bin (EXEs/DLLs)\r
73 respectively.\r
75 After the build of ATK, the "install" project will copy build results\r
76 and headers into their appropriate location under <root>\vs9\<PlatformName>.\r
77 For instance, built DLLs go into <root>\vs9\<PlatformName>\bin, built LIBs into\r
78 <root>\vs9\<PlatformName>\lib and atk headers into\r
79 <root>\vs9\<PlatformName>\include\atk-1.0. This is then from where\r
80 project files higher in the stack are supposed to look for them, not\r
81 from a specific ATK source tree.\r
83 --Chun-wei Fan <fanc999@yahoo.com.tw>\r
84 --(adapted from the GLib VS9 README.txt file originally written by Tor Lillqvist)\r