Document wxUILocale::UseLocaleName()

[utelle]

Under certain circumstances it can make sense to use a locale other than the default user locale.

One example would be, if an application wants to use a UI translation with an RTL language (like Arabic) on a non-RTL system. This wouldn't work with the default locale, because the layout direction would be wrong.

Currently setting a non-default locale can already be achieved via wxLocale anyway. Therefore wxUILocale::UseLocaleName() should be made public, to allow for less side effects than using wxLocale.

[wh11204]

You should remove also this comment from uilocale.h:

// This is a compatibility function used by wxWidgets itself, don't use it
// in the new code.

[wh11204]

I use this method in my applications because IMHO changing the language should change the locale accordingly. An english user in a spanish computer may prefer using the program in english with the english locale, not with the spanish one.