Add length parameter to AddTextRaw and AppendTextRaw. Closes #1358

[wxWidgets.git] / interface / wx / encconv.h

diff --git a/interface/wx/encconv.h b/interface/wx/encconv.h
index 6aa6b71c3323a43bc161b27253ab0945ecbd365f..7bf0a48c535b7a5e3c87075675f8341f9539f1c3 100644 (file)
--- a/interface/wx/encconv.h
+++ b/interface/wx/encconv.h
@@ -3,29 +3,27 @@
 // Purpose:     interface of wxEncodingConverter
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 /**
     @class wxEncodingConverter
 
     This class is capable of converting strings between two 8-bit encodings/charsets.
-    It can also convert from/to Unicode (but only if you compiled wxWidgets
-    with wxUSE_WCHAR_T set to 1).
+    It can also convert from/to Unicode.
 
     Only a limited subset of encodings is supported by wxEncodingConverter:
     @c wxFONTENCODING_ISO8859_1..15, @c wxFONTENCODING_CP1250..1257 and
     @c wxFONTENCODING_KOI8.
 
     @note
-
     Please use wxMBConv classes instead if possible. wxCSConv has much better
     support for various encodings than wxEncodingConverter.
     wxEncodingConverter is useful only if you rely on wxCONVERT_SUBSTITUTE mode
     of operation (see wxEncodingConverter::Init()).
 
     @library{wxbase}
-    @category{misc}
+    @category{conv}
 
     @see wxFontMapper, wxMBConv, @ref overview_nonenglish
 */
@@ -65,9 +63,6 @@ public:
         considered a lossless operation.
 
         @note You must call Init() before using this method!
-
-        @note wchar_t versions of the method are not available if wxWidgets was
-              compiled with @c wxUSE_WCHAR_T set to 0.
     */
     bool Convert(const char* input, char* output) const;
     bool Convert(const wchar_t* input, wchar_t* output) const;
@@ -75,12 +70,23 @@ public:
     bool Convert(const wchar_t* input, char* output) const;
 
     /**
-        Convert input string according to settings passed to Init() in-place,
-        i.e. write the result to the same memory area.
+        Convert input string according to settings passed to Init() in-place.
+
+        With this overload, the conversion result is written to the same memory
+        area from which the input is read.
 
         See the Convert(const char*,char*) const overload for more info.
     */
     bool Convert(char* str) const;
+
+    /**
+        Convert input string according to settings passed to Init() in-place.
+
+        With this overload, the conversion result is written to the same memory
+        area from which the input is read.
+
+        See the Convert(const wchar_t*,wchar_t*) const overload for more info.
+    */
     bool Convert(wchar_t* str) const;
 
     /**