The locale for C function is required by the ConsoleAppender

Author: stephen-webb

src/site/markdown/faq.md

@@ -52,23 +52,25 @@ used that take `LogString` as arguments, the macro `LOG4CXX_STR()` can be used t
 to the current `LogString` type. 
 
 The default external representation is controlled by the `LOG4CXX_CHARSET` cmake option.
-FileAppenders support an `Encoding` property allowing character set encoding control per appender.
-For example, you can use `UTF-8` or `UTF-16` when writing XML or JSON layouts.
+This default is used to encode a multi-byte characters
+unless an `Encoding` property is explicitly configured
+for the log4cxx::FileAppender specialization use use.
+Note you should use `UTF-8` or `UTF-16` encoding when writing XML or JSON layouts.
 Log4cxx also implements character set encodings for `US-ASCII` (`ISO646-US` or `ANSI_X3.4-1968`)
 and `ISO-8859-1` (`ISO-LATIN-1` or `CP1252`).
 You are highly encouraged to stick to `UTF-8` for the best support from tools and operating systems.
 
 The `locale` character set encoding provides support beyond the above internally implemented options.
 It allows you to use any multi-byte encoding provided by the standard library.
-See also [some SO post](https://stackoverflow.com/questions/571359/how-do-i-set-the-proper-initial-locale-for-a-c-program-on-windows)
-on setting the default locale in C++.
+If using the `locale` character set encoding or the log4cxx::ConsoleAppender
+you will need to explicitly configure the system locale at startup.
 
 ```
-std::setlocale( LC_ALL, "" ); /* Set locale for C functions */
-std::locale::global(std::locale("")); /* set locale for C++ functions */
+std::setlocale( LC_ALL, "" ); /* Set user-preferred locale for the ConsoleAppender */
+std::locale::global(std::locale("")); /* Set user-preferred locale for FileAppenders */
 ```
 
-According to the [libc documentation](https://www.gnu.org/software/libc/manual/html_node/Setting-the-Locale.html),
+This is necessary because, according to the [libc documentation](https://www.gnu.org/software/libc/manual/html_node/Setting-the-Locale.html),
 all programs start in the `C` locale by default, which is the [same as ANSI_X3.4-1968](https://stackoverflow.com/questions/48743106/whats-ansi-x3-4-1968-encoding)
 and what's commonly known as the encoding `US-ASCII`. That encoding supports a very limited set of
 characters only, so inputting Unicode with that encoding in effect to output characters can't work
@@ -85,8 +87,3 @@ loggername - ?????????? ???? ??????????????
 
 The important thing to understand is that this is some always applied, backwards compatible default
 behaviour and even the case when the current environment sets a locale like `en_US.UTF-8`.
-
-So when using the `locale` character set encoding you will, at startup,
-need to explicitly set the `std::locale` to a value able to encode your characters
-and which is supported on your operating environment.
-