VS2010 support: Update README.txt
authorChun-wei Fan <fanchunwei@src.gnome.org>
Fri, 16 Sep 2011 03:37:25 +0000 (11:37 +0800)
committerChun-wei Fan <fanchunwei@src.gnome.org>
Fri, 16 Sep 2011 03:37:25 +0000 (11:37 +0800)
-This file should have Windows EOL
-Tell people about GNOME Live! page for steps to building Pango with MSVC
 (and the GTK+ stack)
-Fix some errors in some of the words used here.

build/win32/vs10/README.txt

index 347e2f3..a73e907 100644 (file)
@@ -1,88 +1,96 @@
-Note that all this is rather experimental.
-
-This VS10 solution and the projects it includes are intented to be used
-in a Pango source tree unpacked from a tarball. In a git checkout you
-first need to use some Unix-like environment or manual work to expand
-files as needed, for instance the .vcprojin files here into .vcproj
-files.
-
-
-It is recommended that GLib is compiled with VS10 to compile Pango.
-External dependencies are at least Cairo,  zlib, libpng,
-gettext-runtime; optional dependencies include fontconfig, freetype,
-and expat.  Please see the build\win32\vs10\README.txt file in glib
-for details where to unpack them.
-
-Decide first whether you would want to use fontconfig (which also includes
-freetype) prior to starting this build-Cairo needs to be built with freetype
-*and* fontconfig support before building Pango.  You will need fontconfig
-support if you plan on building GIMP, or if you need support for complex
-language scripts via fontconfig.
-
-It is recommended that one builds the dependencies with VS10 as far as
-possible, especially those from and using the GTK+ stack (i.e. GLib and
-Cairo, [Cairo if one is planning to use GTK+ 3.x]), so that crashes
-caused by mixing calls to different CRTs can be kept at a minimum.
-zlib, libpng, and Cairo do contain support for compiling under VS10
-using VS project files and/or makefiles at this time of writing.
-For GLib, VS10 project files are available under
-$(srcroot)\build\vs10 in the case of GLib (stable/unstable).
-
-There is no known official VS10 build support for fontconfig
-(along with freetype and expat which will work with the pre-compiled
-fontconfig binary on ftp.gnome.org) and gettext-runtime, so please use
-the binaries from:
-
-ftp://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ (32 bit)
-ftp://ftp.gnome.org/pub/GNOME/binaries/win64/dependencies/ (64 bit)
-
-Set up the source tree as follows under some arbitrary top folder
-<root>:
-
-<root>\<this-pango-source-tree>
-<root>\vs10\<PlatformName>
-
-Unzip the binaries obtained from ftp.gnome.org in <root>\vs10\<PlatformName>,
-and build the following, if not already done so: 
-
-Note: put the resulting zlib, libpng, pcre and Cairo files as follows:
- .dll files: <root>\vs10\<PlatformName>\bin
- .lib files: <root>\vs10\<PlatformName>\lib
- .h files: <root>\vs10\<PlatformName>\include
-
-The recommended build order for these dependencies:
-(first unzip any dependent binaries downloaded from the ftp.gnome.org
- as described in the README.txt file in the build\win32\vs10 folder)
--zlib
--libpng
--(optional for GLib) PCRE (version 8.12 or later, use of CMake to
-  build PCRE is recommended-see build\win32\vs10\README.txt of GLib)
--GLib (put the sources in <root>\<GLib-Source-Tree>, and build it from
-       there with VS10)
--Cairo (inclusive of Cairo-GObject-if using GTK+-3.x)
-
-Use the pango_fc.sln solution if usage of fontconfig is desired; otherwise
-use the pango.sln solution.
-
-*this* file you are now reading is thus located at
-<root>\<this-pango-source-tree>\build\win32\vs10\README.txt.
-
-<PlatformName> is either Win32 or x64, as in VS10 project files.
-
-You should unpack the glib-dev zip file into
-<root>\vs10\<PlatformName>, so that for instance glib.h ends up at
-<root>\vs10\<PlatformName>\include\glib-2.0\glib.h.
-
-The "install" project will copy build results and headers into their
-appropriate location under <root>\vs10\<PlatformName>. For instance,
-built DLLs go into <root>\vs10\<PlatformName>\bin, built LIBs into
-<root>\vs10\<PlatformName>\lib and headers into
-<root>\vs10\<PlatformName>\include\pangpo-1.0. This is then from where
-project files higher in the stack are supposed to look for them, not
-from a specific Pango source tree like this one. It is important to
-keep separate the concept of a "source tree", where also non-public
-headers are present, and an "install tree" where only public headers
-are present.
-
---Tor Lillqvist <tml@iki.fi>
---Updated by Fan, Chun-wei <fanc999@yahoo.com.tw>
+Note that all this is rather experimental.\r
+\r
+Please do not compile Pango in a path with spaces to avoid potential\r
+problems during the build and/or during the usage of the Pango\r
+library.\r
+\r
+Please refer to the following GNOME Live! page for more detailed\r
+instructions on building Pango and its dependencies with Visual C++:\r
+\r
+https://live.gnome.org/GTK%2B/Win32/MSVCCompilationOfGTKStack\r
+\r
+This VS10 solution and the projects it includes are intented to be used\r
+in a Pango source tree unpacked from a tarball. In a git checkout you\r
+first need to use some Unix-like environment or manual work to expand\r
+files as needed, for instance the .vcxprojin/vcxproj.filtersin files\r
+here into .vcxproj/.vcxproj.filters files.\r
+\r
+It is recommended that GLib is compiled with VS10 to compile Pango.\r
+External dependencies are at least Cairo,  zlib, libpng,\r
+gettext-runtime; optional dependencies include fontconfig, freetype,\r
+and expat.  Please see the build\win32\vs10\README.txt file in glib\r
+for details where to unpack them.\r
+\r
+Decide first whether you would want to use fontconfig (which also includes\r
+freetype) prior to starting this build-Cairo needs to be built with freetype\r
+*and* fontconfig support before building Pango.  You will need fontconfig\r
+support if you plan on building GIMP, or if you need support for complex\r
+language scripts via fontconfig.\r
+\r
+It is recommended that one builds the dependencies with VS10 as far as\r
+possible, especially those from and using the GTK+ stack (i.e. GLib and\r
+Cairo, [Cairo if one is planning to use GTK+ 3.x]), so that crashes\r
+caused by mixing calls to different CRTs can be kept at a minimum.\r
+zlib, libpng, and Cairo do contain support for compiling under VS10\r
+using VS project files and/or makefiles at this time of writing.\r
+For GLib, VS10 project files are available under\r
+$(srcroot)\build\vs10 in the case of GLib (stable/unstable).\r
+\r
+There is no known official VS10 build support for fontconfig\r
+(along with freetype and expat which will work with the pre-compiled\r
+fontconfig binary on ftp.gnome.org) and gettext-runtime, so please use\r
+the binaries from:\r
+\r
+ftp://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ (32 bit)\r
+ftp://ftp.gnome.org/pub/GNOME/binaries/win64/dependencies/ (64 bit)\r
+\r
+Set up the source tree as follows under some arbitrary top folder\r
+<root>:\r
+\r
+<root>\<this-pango-source-tree>\r
+<root>\vs10\<PlatformName>\r
+\r
+Unzip the binaries obtained from ftp.gnome.org in <root>\vs10\<PlatformName>,\r
+and build the following, if not already done so: \r
+\r
+Note: put the resulting zlib, libpng, pcre and Cairo files as follows:\r
+ .dll files: <root>\vs10\<PlatformName>\bin\r
+ .lib files: <root>\vs10\<PlatformName>\lib\r
+ .h files: <root>\vs10\<PlatformName>\include\r
+\r
+The recommended build order for these dependencies:\r
+(first unzip any dependent binaries downloaded from the ftp.gnome.org\r
+ as described in the README.txt file in the build\win32\vs10 folder)\r
+-zlib\r
+-libpng\r
+-(optional for GLib) PCRE (version 8.12 or later, use of CMake to\r
+  build PCRE is recommended-see build\win32\vs10\README.txt of GLib)\r
+-GLib (put the sources in <root>\<GLib-Source-Tree>, and build it from\r
+       there with VS10)\r
+-Cairo (inclusive of Cairo-GObject-if using GTK+-3.x)\r
+\r
+Use the pango_fc.sln solution if usage of fontconfig is desired; otherwise\r
+use the pango.sln solution.\r
+\r
+*this* file you are now reading is thus located at\r
+<root>\<this-pango-source-tree>\build\win32\vs10\README.txt.\r
+\r
+<PlatformName> is either Win32 or x64, as in VS10 project files.\r
+\r
+You should unpack the glib-dev zip file into\r
+<root>\vs10\<PlatformName>, so that for instance glib.h ends up at\r
+<root>\vs10\<PlatformName>\include\glib-2.0\glib.h.\r
+\r
+The "install" project will copy build results and headers into their\r
+appropriate location under <root>\vs10\<PlatformName>. For instance,\r
+built DLLs go into <root>\vs10\<PlatformName>\bin, built LIBs into\r
+<root>\vs10\<PlatformName>\lib and headers into\r
+<root>\vs10\<PlatformName>\include\pangpo-1.0. This is then from where\r
+project files higher in the stack are supposed to look for them, not\r
+from a specific Pango source tree like this one. It is important to\r
+keep separate the concept of a "source tree", where also non-public\r
+headers are present, and an "install tree" where only public headers\r
+are present.\r
+\r
+--Tor Lillqvist <tml@iki.fi>\r
+--Updated by Fan, Chun-wei <fanc999@yahoo.com.tw>\r