From a9fd08ff5ab8bbf3838200ceace671a72627d212 Mon Sep 17 00:00:00 2001
From: Matthias Melcher <fltk@matthiasm.com>
Date: Sat, 23 Jun 2018 16:47:40 +0000
Subject: 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
---
 src/fl_encoding_latin1.cxx | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

(limited to 'src/fl_encoding_latin1.cxx')

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$".
 //
-- 
cgit v1.2.3