From 79b40dcf0746e3deb7526c5a80540b095a8b7de6 Mon Sep 17 00:00:00 2001
From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Sat, 31 May 2008 22:35:24 +0000
Subject: [PATCH] create a separate category for the conversion classes

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@53883 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 docs/doxygen/groups/class_conv.h     | 17 +++++++++++++++++
 docs/doxygen/mainpages/cat_classes.h | 18 ++++++++++++++++++
 interface/strconv.h                  | 20 +++++++++-----------
 3 files changed, 44 insertions(+), 11 deletions(-)
 create mode 100644 docs/doxygen/groups/class_conv.h

diff --git a/docs/doxygen/groups/class_conv.h b/docs/doxygen/groups/class_conv.h
new file mode 100644
index 0000000000..e655f8e276
--- /dev/null
+++ b/docs/doxygen/groups/class_conv.h
@@ -0,0 +1,17 @@
+/////////////////////////////////////////////////////////////////////////////
+// Name:        class_conv.h
+// Purpose:     Conversion classes group docs
+// Author:      wxWidgets team
+// RCS-ID:      $Id$
+// Licence:     wxWindows license
+/////////////////////////////////////////////////////////////////////////////
+
+/**
+
+@defgroup group_class_conv Text Conversion
+@ingroup group_class
+
+These are the classes used for conversions between different text encodings.
+
+*/
+
diff --git a/docs/doxygen/mainpages/cat_classes.h b/docs/doxygen/mainpages/cat_classes.h
index fae07d785c..9b036a0979 100644
--- a/docs/doxygen/mainpages/cat_classes.h
+++ b/docs/doxygen/mainpages/cat_classes.h
@@ -44,6 +44,7 @@ This page contains a summarized listing of classes, please see the
 @li @ref page_class_cat_logging
 @li @ref page_class_cat_threading
 @li @ref page_class_cat_data
+@li @ref page_class_cat_conv
 @li @ref page_class_cat_containers
 @li @ref page_class_cat_smartpointers
 @li @ref page_class_cat_file
@@ -657,6 +658,23 @@ These are the data structure classes supported by wxWidgets.
 
 
 
+@section page_class_cat_conv Text Conversion
+
+These classes define objects for performing conversions between different
+multibyte and Unicode encodings and wide character strings.
+
+@li wxMBConv: Base class for all convertors, defines the API implemented by all
+    the other convertor classes.
+@li wxMBConvUTF7: Convertor for UTF-7
+@li wxMBConvUTF8: Convertor for UTF-8
+@li wxMBConvUTF16: Convertor for UTF-16
+@li wxMBConvUTF32: Convertor for UTF-32
+@li wxCSConv: Convertor for any system-supported encoding which can be
+    specified by name.
+
+Related Overviews: @ref overview_mbconv
+
+
 @section page_class_cat_containers Containers
 
 These are classes, templates and class macros are used by wxWidgets. Most of
diff --git a/interface/strconv.h b/interface/strconv.h
index fafa722f2b..c2076bc14c 100644
--- a/interface/strconv.h
+++ b/interface/strconv.h
@@ -13,10 +13,8 @@
     This class converts between the UTF-7 encoding and Unicode.
     It has one predefined instance, @b wxConvUTF7.
 
-    @b WARNING: this class is not implemented yet.
-
     @library{wxbase}
-    @category{FIXME}
+    @category{conv}
 
     @see wxMBConvUTF8, @ref overview_mbconv "wxMBConv classes overview"
 */
@@ -46,7 +44,7 @@ public:
     It has one predefined instance, @b wxConvUTF8.
 
     @library{wxbase}
-    @category{FIXME}
+    @category{conv}
 
     @see wxMBConvUTF7, @ref overview_mbconv "wxMBConv classes overview"
 */
@@ -81,7 +79,7 @@ public:
     under Mac).
 
     @library{wxbase}
-    @category{FIXME}
+    @category{conv}
 
     @see wxMBConvUTF8, wxMBConvUTF32, @ref overview_mbconv "wxMBConv classes overview"
 */
@@ -112,7 +110,7 @@ public:
     default user character set.
 
     @library{wxbase}
-    @category{FIXME}
+    @category{conv}
 
     @see wxMBConv, wxEncodingConverter, @ref overview_mbconv "wxMBConv classes overview"
 */
@@ -125,9 +123,9 @@ public:
         is used as fall back.
     */
     wxCSConv(const wxChar* charset);
-    
+
     /**
-        Constructor. You can specify an encoding constant for the 
+        Constructor. You can specify an encoding constant for the
         character set you want to convert from/to or. If the encoding
         is not recognized, ISO 8859-1 is used as fall back.
     */
@@ -193,7 +191,7 @@ public:
     (although it would be better to use wxFopen(name, wxT("r")) in this case.)
 
     @library{wxbase}
-    @category{FIXME}
+    @category{conv}
 
     @see @ref overview_mbconv "wxMBConv classes overview"
 */
@@ -228,7 +226,7 @@ public:
     under Mac).
 
     @library{wxbase}
-    @category{FIXME}
+    @category{conv}
 
     @see wxMBConvUTF8, wxMBConvUTF16, @ref overview_mbconv "wxMBConv classes overview"
 */
@@ -266,7 +264,7 @@ public:
     under Windows) or 4 (Unix).
 
     @library{wxbase}
-    @category{FIXME}
+    @category{conv}
 
     @see wxCSConv, wxEncodingConverter, @ref overview_mbconv "wxMBConv classes overview"
 */
-- 
2.45.2