Changes between Version 9 and Version 10 of ConfigOptions

Timestamp:

Feb 24, 2011, 2:44:52 PM (13 years ago)

Author:

warmerdam

Comment:

document GDAL_FILENAME_IS_UTF8 and GDAL_DISABLE_CPLLOCALEC

ConfigOptions

@@ -71 +71 @@
 
 On some builds (Unix), the value can be hard-coded at compilation time to point to the path after installation (/usr/share/gdal/data for example). On Windows platform, this option must be generally declared.
+
+=== GDAL_DISABLE_CPLLOCALEC ===
+
+If set to YES (deafault is NO) this option will disable the normal behavior of the CPLLocaleC class which forces the numeric locale to "C" for selected chunks of code using the setlocale() call.  Behavior of setlocale() in multi-threaded applications may be undependable but use of this option may result in problem formatting and interpreting numbers properly. 
+
+=== GDAL_FILENAME_IS_UTF8 ===
+
+This option only has an effect on Windows systems (using cpl_vsil_win32.cpp).  If set to "NO" (default is YES) then filenames passed to functions like VSIFOpenL() will be passed on directly to CreateFile() instead of being converted from UTF-8 to wchar_t and passed to CreateFileW().  This effectively restores the pre-GDAL1.8 behavior for handling filenames on Windows and might be appropriate for applications that treat filenames as being in the local encoding.
 
 === GEOTIFF_CSV ===