//
// Copyright (c) 2009-2011 Artyom Beilis (Tonkikh)
//
// Distributed under the Boost Software License, Version 1.0.
// https://www.boost.org/LICENSE_1_0.txt

/*!

\mainpage Boost.Locale

\section main_intro What is Boost.Locale?

Boost.Locale is a library that provides high quality
localization facilities in C++. It was originally designed
a part of <a href="http://cppcms.sourceforge.net/">CppCMS</a> - C++ Web Framework
project and then contributed to Boost.

Boost.Locale gives powerful tools for development of cross platform
localized software - the software that talks to user
in its language.

Features:

-   Correct case conversion, case folding and normalization.
-   Collation (sorting), including support for 4 Unicode
    collation levels.
-   Date, time, timezone and calendar manipulations,
    formatting and parsing, including transparent support
    for calendars other than Gregorian.
-   Boundary analysis for characters, words, sentences and
    line-breaks.
-   Number formatting, spelling and parsing.
-   Monetary formatting and parsing.
-   Powerful message formatting (string translation)
    including support for plural forms, using GNU catalogs.
-   Character set conversion.
-   Transparent support for 8-bit character sets like Latin1.
-   Support for \c char and \c wchar_t.
-   Experimental support for C++11 \c char16_t and \c char32_t
    strings and streams.

Boost.Local complements the standard library's API, making it easy
to write cross platform and "cross culture" software.

In order to achieve this goal, Boost.Locale uses the
state-of-the-art Unicode and Localization
library: <a href="http://icu-project.org/">ICU</a> - International Components for Unicode.

Boost.Locale creates the natural glue between the C++ locales
framework, iostreams, and the powerful ICU library.

Boost.Locale provides non-ICU based localization support as well.
It is based on the operating system native API or on the standard
C++ library support. Sacrificing some less important features,
Boost.Locale becomes less powerful but lighter and easier to deploy.


\section main_tutorial Tutorials

- \subpage std_locales
- \subpage using_boost_locale
    - \ref locale_gen
    - \ref collation
    - \ref conversions
    - \ref formatting_and_parsing
    - \ref messages_formatting
    - \ref charset_handling
    - \ref boundary_analysys
    - \ref localized_text_formatting
    - \ref dates_times_timezones
    - \ref locale_information
    - \ref working_with_multiple_locales
- \subpage using_localization_backends
- \subpage recommendations_and_myths
- \subpage building_boost_locale
- \subpage appendix
    - \ref rationale
    - \ref faq
    - \ref default_encoding_under_windows
    - \ref running_examples_under_windows
    - \ref gettext_for_windows
    - \ref glossary
    - \ref tested_compilers_and_platforms
    - \ref status_of_cpp0x_characters_support
    - \ref special_thanks
- \subpage changelog
*/

