From f7cf1fb5cd412c32acb29e75020db127c9162abe Mon Sep 17 00:00:00 2001
From: Bruce Dubbs <bdubbs@linuxfromscratch.org>
Date: Wed, 16 May 2018 20:54:19 +0000
Subject: Provide better i18n instructions to setting up /etc/fstab.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11411 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
---
 chapter08/fstab.xml | 45 ++++++++++++++++++++++++++++-----------------
 1 file changed, 28 insertions(+), 17 deletions(-)

(limited to 'chapter08')

diff --git a/chapter08/fstab.xml b/chapter08/fstab.xml
index 91ad2dfe0..ebfae3aaf 100644
--- a/chapter08/fstab.xml
+++ b/chapter08/fstab.xml
@@ -56,26 +56,37 @@ EOF</userinput></screen>
   class="filesystem">ext4</systemitem>. For details on the six
   fields in this file, see <command>man 5 fstab</command>.</para>
 
-  <para>Filesystems with MS-DOS or Windows origin (i.e.: vfat, ntfs, smbfs, cifs,
-  iso9660, udf) need the <quote>iocharset</quote> mount option in order for
-  non-ASCII characters in file names to be interpreted properly. The value
-  of this option should be the same as the character set of your locale,
-  adjusted in such a way that the kernel understands it. This works if the
-  relevant character set definition (found under File systems -&gt;
-  Native Language Support) has been compiled into the kernel
-  or built as a module. The <quote>codepage</quote> option is also needed for
-  vfat and smbfs filesystems. It should be set to the codepage number used
-  under MS-DOS in your country. E.g., in order to mount USB flash drives, a
-  ru_RU.KOI8-R user would need the following in the options portion of its
-  mount line in <filename>/etc/fstab</filename>:</para>
-
-<screen><literal>noauto,user,quiet,showexec,iocharset=koi8r,codepage=866</literal></screen>
+  <para>Filesystems with MS-DOS or Windows origin (i.e. vfat, ntfs, smbfs,
+  cifs, iso9660, udf) need a special option, utf8, in order for non-ASCII
+  characters in file names to be interpreted properly. For non-UTF-8 locales,
+  the value of <option>iocharset</option> should be set to be the same as the
+  character set of the locale, adjusted in such a way that the kernel
+  understands it.  This works if the relevant character set definition (found
+  under File systems -&gt; Native Language Support when configuring the kernel)
+  has been compiled into the kernel or built as a module. However, if the
+  character set of the locale is UTF-8, the corresponding option
+  <option>iocharset=utf8</option> would make the file system case sensitive. To
+  fix this, use the special option <option>utf8</option> instead of
+  <option>iocharset=utf8</option>, for UTF-8 locales. The
+  <quote>codepage</quote> option is also needed for vfat and smbfs filesystems.
+  It should be set to the codepage number used under MS-DOS in your country.
+  For example, in order to mount USB flash drives, a ru_RU.KOI8-R user would
+  need the following in the options portion of its mount line in
+  <filename>/etc/fstab</filename>:</para>
+
+<screen><literal>noauto,user,quiet,showexec,codepage=866,iocharset=koi8r</literal></screen>
 
   <para>The corresponding options fragment for ru_RU.UTF-8 users is:</para>
 
-<screen><literal>noauto,user,quiet,showexec,iocharset=utf8,codepage=866</literal></screen>
+<screen><literal>noauto,user,quiet,showexec,codepage=866,utf8</literal></screen>
 
-  <note>
+  <para>Note that using <option>iocharset</option> is the default for
+  <literal>iso8859-1</literal> (which keeps the file system case
+  insensitive), and the <option>utf8</option> option tells
+  the kernel to convert the file names using UTF-8 so they can be
+  interpreted in the UTF-8 locale.</para>
+
+  <!--note>
     <para>In the latter case, the kernel emits the following message:</para>
 
 <screen><computeroutput>FAT: utf8 is not a recommended IO charset for FAT filesystems,
@@ -84,7 +95,7 @@ EOF</userinput></screen>
     <para>This negative recommendation should be ignored, since all other values
     of the <quote>iocharset</quote> option result in wrong display of filenames in
     UTF-8 locales.</para>
-  </note>
+  </note-->
 
   <para>It is also possible to specify default codepage and iocharset values for
   some filesystems during kernel configuration. The relevant parameters
-- 
cgit v1.2.3-54-g00ecf