Add notes on Japanese charsets from Monyo

(This used to be commit 571e14bd07148d95e3e83167e83362bec0502d55)

1 files changed, 26 insertions, 0 deletions

diff --git a/docs/docbook/projdoc/unicode.sgml b/docs/docbook/projdoc/unicode.sgml
index 2f794aadc2..42d2e1d50f 100644
--- a/docs/docbook/projdoc/unicode.sgml
+++ b/docs/docbook/projdoc/unicode.sgml
@@ -1,6 +1,12 @@
 <chapter id="unicode">
 <chapterinfo>
 	&author.jelmer;
+	<author>
+		<firstname>TAKAHASHI</firstname><surname>Motonobu</surname>
+		<affiliation>
+		<address><email>monyo@home.monyo.com</email></address>
+		</affiliation>
+	</author>
 	<pubdate>25 March 2003</pubdate>
 </chapterinfo>
 
@@ -99,4 +105,24 @@ filenames from CP850 to the iso8859-15 charset.</para>
 </userinput>
 </para>
 </sect1>
+
+<sect1>
+<title>Japanese charsets</title>
+
+<para>Samba doesn't work correctly with Japanese charsets yet. Here are points of attention when setting it up:</para>
+
+<simplelist>
+<member>You should set <command>mangling method = hash</command></member>
+<member>There are various iconv() implementations around and not all of 
+them work equally well. glibc2's iconv() has a critical problem in CP932. 
+libiconv-1.8 works with CP932 but still has some problems and does not 
+work with EUC-JP. </member>
+<member>You should set <command>dos charset = CP932</command>, not Shift_JIS, SJIS...</member>
+<member>Currently only <command>unix charset = CP932</command> will work (but still has some problems...) because of iconv() issues. <command>unix charset = EUC-JP</command> doesn't work well because of iconv() issues.</member>
+<member>Currently Samba 3.0 does not support <command>unix charset = UTF8-MAC/CAP/HEX/JIS*</command></member>
+</simplelist>
+
+<para>More information (in Japanese) is available at: <ulink url="http://www.atmarkit.co.jp/flinux/special/samba3/samba3a.html">http://www.atmarkit.co.jp/flinux/special/samba3/samba3a.html</ulink>.</para>
+</sect1>
+
 </chapter>