Mark sal_Char, sal_sChar, sal_uChar as deprecated

...there never was a good reason to have SAL abstractions for the C/C++ char types anyway.

Change-Id: Id5da718cf26f12ebe57bc71e076c32d763c0982e

1 files changed, 17 insertions, 3 deletions

diff --git a/include/sal/types.h b/include/sal/types.h
index c7a61bd06106..ff6bc280b591 100644
--- a/include/sal/types.h
+++ b/include/sal/types.h
@@ -121,9 +121,23 @@ typedef unsigned char       sal_uInt8;
     #error "Please define the 64-bit types for your architecture/compiler in sal/inc/sal/types.h"
 #endif
 
-typedef char                     sal_Char;
-typedef signed char              sal_sChar;
-typedef unsigned char            sal_uChar;
+/** A legacy synonym for `char`.
+
+    @deprecated use plain `char` instead.
+*/
+typedef char sal_Char;
+
+/** A legacy synonym for `signed char`.
+
+    @deprecated use plain `signed char` instead.
+*/
+typedef signed char sal_sChar;
+
+/** A legacy synonym for `unsigned char`.
+
+    @deprecated use plain `unsigned char` instead.
+*/
+typedef unsigned char sal_uChar;
 
 #if ( defined(SAL_W32) && !defined(__MINGW32__) )
     // http://msdn.microsoft.com/en-us/library/s3f49ktz%28v=vs.80%29.aspx