Doxygen: created Group to document drivers, disabled by default

Uncomment `ENABLED_SECTIONS += DriverDev` in documentation/Doxyfile.in
to enable driver documentation.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12968 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

1 files changed, 29 insertions, 1 deletions

diff --git a/src/fl_encoding_latin1.cxx b/src/fl_encoding_latin1.cxx
index 10b899f92..dbb31ad7b 100644
--- a/src/fl_encoding_latin1.cxx
+++ b/src/fl_encoding_latin1.cxx
@@ -115,16 +115,45 @@ const char *Fl_Darwin_System_Driver::local_to_latin1(const char *t, int n)
 
 #endif
 
+/**
+ * @cond DriverDev
+ * @addtogroup DriverDeveloper
+ * @{
+ */
+
+/**
+ * Default implementation of latin-to-local text conversion.
+ *
+ * The default implementation returns the original text. This method should
+ * be reimplemented by drivers for platforms that commonly use latin
+ * text encoding.
+ *
+ * @see fl_latin1_to_local(const char *, int)
+ */
 const char *Fl_System_Driver::latin1_to_local(const char *t, int)
 {
   return t;
 }
 
+/**
+ * Default implementation of local-to-latin text conversion.
+ *
+ * The default implementation returns the original text. This method should
+ * be reimplemented by drivers for platforms that commonly use latin
+ * text encoding.
+ *
+ * @see fl_local_to_latin1(const char *, int)
+ */
 const char *Fl_System_Driver::local_to_latin1(const char *t, int)
 {
   return t;
 }
 
+/**
+ * @}
+ * @endcond
+ */
+
 const char *fl_latin1_to_local(const char *t, int n)
 {
   return Fl::system_driver()->latin1_to_local(t, n);
@@ -135,7 +164,6 @@ const char *fl_local_to_latin1(const char *t, int n)
   return Fl::system_driver()->local_to_latin1(t, n);
 }
 
-
 //
 // End of "$Id$".
 //