//
//  Copyright (c) 2009-2011 Artyom Beilis (Tonkikh)
//
//  Distributed under the Boost Software License, Version 1.0. (See
//  accompanying file LICENSE_1_0.txt or copy at
//  http://www.boost.org/LICENSE_1_0.txt)
//

// vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 filetype=cpp.doxygen

/*!

\mainpage Boost.Locale

\section main_intro What is Boost.Locale?

Boost.Locale is a library that provides high quality
localization facilities in a C++ way. 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.

Provided 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++0x \c char16_t and \c char32_t
    strings and streams.

Boost.Locale enhances and unifies the standard library's API
the way it becomes useful and convenient for development
of 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
and use library.


\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_paltforms 
    - \ref status_of_cpp0x_characters_support
    - \ref special_thanks
- \subpage changelog
*/