summaryrefslogtreecommitdiff
path: root/README.win32
diff options
context:
space:
mode:
authorChun-wei Fan <fanchunwei@src.gnome.org>2013-11-25 15:26:25 +0800
committerChun-wei Fan <fanchunwei@src.gnome.org>2013-11-25 15:26:25 +0800
commit0dbe5c43df6d3eb32abe766ed08da525a8c8bfa4 (patch)
tree72e0abea808b3981de8185e8c870ea96f23bde2c /README.win32
parent3d70db075005a94d7fd18ac8a8dbd0abb82bff9e (diff)
downloadglib-0dbe5c43df6d3eb32abe766ed08da525a8c8bfa4.tar.gz
msvc_recommended_pragmas.h: Treat C4819 warnings as errors
Warning C4819 in Visual Studio builds indicates an issue of Visual Studio 2005 and later running on East Asian locales of Windows, which likely results in broken builds of GLib, Pango, GTK+, and possibly other GNOME projects such as Cogl and Clutter (and is also an issue when building other projects like QT and Firefox). Treat this warning as an error as a result when building GLib-based items on Visual Studio, and tell people how to remedy this issue correctly.
Diffstat (limited to 'README.win32')
-rw-r--r--README.win3215
1 files changed, 15 insertions, 0 deletions
diff --git a/README.win32 b/README.win32
index 520cbdb9c..3ef45c549 100644
--- a/README.win32
+++ b/README.win32
@@ -67,6 +67,20 @@ you would be allowed by the license to distrubute a GLib linked to
msvcr70.dll or msvcr80.dll, as those are not part of the operating
system, but of the MSVC product. msvcrt.dll is part of Windows.
+For people using Visual Studio 2005 or later:
+
+If you are building GLib-based libraries or applications, or GLib itself
+and you see a C4819 error (or warning, before C4819 is treated as an error
+in msvc_recommended_pragmas.h), please be advised that this error/warning should
+not be disregarded, as this likely means portions of the build is not being
+done correctly, as this is an issue of Visual Studio running on CJK (East Asian)
+locales. This is an issue that also affects builds of other projects, such as
+QT, Firefox, LibreOffice/OpenOffice, Pango and GTK+, along with many other projects.
+
+To overcome this problem, please set your system's locale setting for non-Unicode to
+English (United States), reboot, and restart the build, and the code should build
+normally. See also this GNOME Wiki page [1] that gives a bit further info on this.
+
Building software that use GLib or GTK+
=======================================
@@ -367,3 +381,4 @@ dependencies order.
+- plug-ins
+- python
+[1]: https://wiki.gnome.org/Projects/GTK%2B/Win32/MSVCCompilationOfGTKStack under "Preparations"