added interface headers with latest discussed changes

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52381 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

interface/chartype.h

@@ -0,0 +1,47 @@
+/////////////////////////////////////////////////////////////////////////////
+    // Name:        chartype.h
+    // Purpose:     documentation for global functions
+    // Author:      wxWidgets team
+    // RCS-ID:      $Id$
+    // Licence:     wxWindows license
+    /////////////////////////////////////////////////////////////////////////////
+    
+    //@{
+/**
+    wxT() is a macro which can be used with character and string literals (in other
+    words, @c 'x' or @c "foo") to automatically convert them to Unicode in
+    Unicode build configuration. Please see the
+    @ref overview_unicode "Unicode overview" for more information.
+    
+    This macro is simply returns the value passed to it without changes in ASCII
+    build. In fact, its definition is:
+    
+    @code
+    #ifdef UNICODE
+    #define wxT(x) L ## x
+    #else // !Unicode
+    #define wxT(x) x
+    #endif
+    @endcode
+*/
+wxChar wxT(char ch);
+    const wxChar * wxT(const char * s);
+//@}
+
+
+    //@{
+/**
+    wxS is macro which can be used with character and string literals to either
+    convert them to wide characters or strings in @c wchar_t-based Unicode
+    builds or keep them unchanged in UTF-8 builds. The use of this macro is
+    optional as the translation will always be done at run-time even if there is a
+    mismatch between the kind of the literal used and wxStringCharType used in the
+    current build, but using it can be beneficial in performance-sensitive code to
+    do the conversion at compile-time instead.
+    
+    @sa wxT
+*/
+wxStringCharType wxS(char ch);
+    const wxStringCharType * wxS(const char * s);
+//@}
+