build/win32/vs9/README.txt

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