[Libreoffice-commits] core.git: include/rtl

[Stephan Bergmann]

 include/rtl/locale.h |   19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

New commits:
commit 46b8d2b78a95b8ff7d0f6c63a4d716a7be4dd2a1
Author: Stephan Bergmann <sbergman at redhat.com>
Date:   Tue Mar 21 16:31:33 2017 +0100

    Mark rtl_locale_get/setDefault as deprecated
    
    unused in LO itself since 73bda5058bcef6be9a3185aa46375c7b147ffa22 "ditched
    rtl::OLocale"
    
    Change-Id: I6fd713f4771d7a7a397ef08002d1b9d754417f67

diff --git a/include/rtl/locale.h b/include/rtl/locale.h
index ee6ee8f8011d..050e08656197 100644
--- a/include/rtl/locale.h
+++ b/include/rtl/locale.h
@@ -74,24 +74,23 @@ SAL_DLLPUBLIC rtl_Locale * SAL_CALL rtl_locale_register(
 
 /**
     Common method of getting the current default Locale.
-    Used for the presentation: menus, dialogs, etc.
-    Generally set once when your applet or application is initialized,
-    then never reset. (If you do reset the default locale, you
-    probably want to reload your GUI, so that the change is reflected
-    in your interface.)
-    <p>More advanced programs will allow users to use different locales
-    for different fields, e.g. in a spreadsheet.
-    <BR>Note that the initial setting will match the host system.
+
+    @deprecated  LibreOffice itself does not use this anymore, and client code
+    should not have good use for it either.  It may eventually be removed.
  */
 SAL_DLLPUBLIC rtl_Locale * SAL_CALL rtl_locale_getDefault(void);
 
 /**
     Sets the default.
-    Normally set once at the beginning of applet or application,
-    then never reset. <code>setDefault</code> does not reset the host locale.
+
+    <code>setDefault</code> does not reset the host locale.
+
     @param language lowercase two-letter ISO 639-1 or three-letter ISO 639-3 code.
     @param country uppercase two-letter ISO-3166 code.
     @param variant vendor and browser specific code. See class description.
+
+    @deprecated  LibreOffice itself does not use this anymore, and client code
+    should not have good use for it either.  It may eventually be removed.
  */
 SAL_DLLPUBLIC void SAL_CALL rtl_locale_setDefault(
         const sal_Unicode * language, const sal_Unicode * country, const sal_Unicode * variant );