From 5b5453e6c799cbf3fa7638950825e3b1c276cdc2 Mon Sep 17 00:00:00 2001
From: Martin Pool <mbp@samba.org>
Date: Mon, 24 Feb 2003 04:42:24 +0000
Subject: Merge documentation from 3_0. (This used to be commit
 5002555a9719987ccdc887ffff64ea8d02c9881d)

---
 source3/lib/charcnv.c | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

(limited to 'source3/lib')

diff --git a/source3/lib/charcnv.c b/source3/lib/charcnv.c
index bffa2a378c..a8df003f8b 100644
--- a/source3/lib/charcnv.c
+++ b/source3/lib/charcnv.c
@@ -22,17 +22,24 @@
 */
 #include "includes.h"
 
-static pstring cvtbuf;
-
-static smb_iconv_t conv_handles[NUM_CHARSETS][NUM_CHARSETS];
-
 /**
  * @file
  *
- * Character set conversion routines.
+ * @brief Character-set conversion routines built on our iconv.
+ * 
+ * @note Samba's internal character set (at least in the 3.0 series)
+ * is always the same as the one for the Unix filesystem.  It is
+ * <b>not</b> necessarily UTF-8 and may be different on machines that
+ * need i18n filenames to be compatible with Unix software.  It does
+ * have to be a superset of ASCII.  All multibyte sequences must start
+ * with a byte with the high bit set.
  *
  * @sa lib/iconv.c
- **/
+ */
+
+static pstring cvtbuf;
+
+static smb_iconv_t conv_handles[NUM_CHARSETS][NUM_CHARSETS];
 
 
 /**
-- 
cgit