running_examples_under_windows.txt 1.6 KB

123456789101112131415161718192021222324252627282930313233343536
  1. //
  2. // Copyright (c) 2009-2011 Artyom Beilis (Tonkikh)
  3. //
  4. // Distributed under the Boost Software License, Version 1.0. (See
  5. // accompanying file LICENSE_1_0.txt or copy at
  6. // http://www.boost.org/LICENSE_1_0.txt)
  7. //
  8. // vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 filetype=cpp.doxygen
  9. /*!
  10. \page running_examples_under_windows Running Examples under Microsoft Windows
  11. All of the examples that come with Boost.Locale are designed for UTF-8 and it is
  12. the default encoding used by Boost.Locale.
  13. However, the default narrow encoding under Microsoft Windows is not UTF-8 and
  14. the output of the applications would not be displayed correctly in the console.
  15. So in order to use UTF-8 encoding under the Windows console and see the output correctly, do the following:
  16. -# Open a \c cmd window
  17. -# Change the default font to a TrueType font: go to properties-\>font (right click on title-bar-\>properties-\>font) and
  18. change the font to a TrueType font like Lucida Console
  19. -# Change the default codepage to 65001 (UTF-8) by running <tt>chcp 65001</tt>
  20. Now all of the examples should display UTF-8 characters correctly (if the font supports them).
  21. <b>Note for Visual Studio users:</b> Microsoft Visual Studio assumes that all source files are encoded using an "ANSI" codepage
  22. like 1252. However all examples use UTF-8 encoding by default, so wide character examples would
  23. not work under MSVC as-is. In order to force it to treat source files as UTF-8 you need to
  24. convert the files to UTF-8 with BOM, which can be done easily by re-saving them from Notepad,
  25. which adds a BOM to UTF-8 files by default.
  26. */