r5500 - in trunk/BOOK: general/sysutils introduction/important introduction/welcome

randy at linuxfromscratch.org randy at linuxfromscratch.org
Wed Dec 28 21:52:20 PST 2005


Author: randy
Date: 2005-12-28 22:52:18 -0700 (Wed, 28 Dec 2005)
New Revision: 5500

Modified:
   trunk/BOOK/general/sysutils/mc.xml
   trunk/BOOK/introduction/important/locale-issues.xml
   trunk/BOOK/introduction/welcome/changelog.xml
Log:
Added a caution note to the MC instructions about the UTF-8 related issues

Modified: trunk/BOOK/general/sysutils/mc.xml
===================================================================
--- trunk/BOOK/general/sysutils/mc.xml	2005-12-29 03:56:17 UTC (rev 5499)
+++ trunk/BOOK/general/sysutils/mc.xml	2005-12-29 05:52:18 UTC (rev 5500)
@@ -5,11 +5,11 @@
   %general-entities;
 
   <!ENTITY mc-download-http "http://www.ibiblio.org/pub/Linux/utils/file/managers/mc/mc-&mc-version;.tar.gz">
-  <!ENTITY mc-download-ftp "ftp://ftp.uni-koeln.de/util/shell/mc-&mc-version;.tar.gz">
-  <!ENTITY mc-md5sum "18b20db6e40480a53bac2870c56fc3c4">
-  <!ENTITY mc-size "3.8 MB">
-  <!ENTITY mc-buildsize "29 MB">
-  <!ENTITY mc-time "0.4 SBU">
+  <!ENTITY mc-download-ftp  "ftp://ftp.uni-koeln.de/util/shell/mc-&mc-version;.tar.gz">
+  <!ENTITY mc-md5sum        "18b20db6e40480a53bac2870c56fc3c4">
+  <!ENTITY mc-size          "3.8 MB">
+  <!ENTITY mc-buildsize     "29 MB">
+  <!ENTITY mc-time          "0.4 SBU">
 ]>
 
 <sect1 id="mc" xreflabel="MC-&mc-version;">
@@ -34,11 +34,18 @@
     <title>Introduction to MC</title>
 
     <para><application>MC</application> (Midnight Commander) is a text-mode
-    full-screen file manager and visual shell. It provides a clear, user-friendly,
-    and somewhat protected interface to a Unix system while making many frequent
-    file operations more efficient and preserving the full power of the command
-    prompt.</para>
+    full-screen file manager and visual shell. It provides a clear,
+    user-friendly, and somewhat protected interface to a Unix system while
+    making many frequent file operations more efficient and preserving the
+    full power of the command prompt.</para>
 
+    <caution>
+      <para>The <application>MC</application> package has some issues when
+      used in a UTF-8 based locale. For a full explanation of the issues, see
+      the <xref linkend="locale-mc"/> section of the
+      <xref linkend="locale-issues"/>.</para>
+    </caution>
+
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
@@ -64,7 +71,8 @@
     <bridgehead renderas="sect3">MC Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
-    <para role="required"><xref linkend="GLib"/> or <xref linkend="glib2"/></para>
+    <para role="required"><xref linkend="GLib"/> or
+    <xref linkend="glib2"/></para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional"><xref linkend="gpm"/>,
@@ -72,7 +80,7 @@
     <xref linkend="samba3"/>,
     <xref linkend="slang"/>,
     <xref linkend="zip"/>,
-    <xref linkend="unzip"/> and
+    <xref linkend="unzip"/>, and
     <xref linkend="gnome-libs"/></para>
 
   </sect2>

Modified: trunk/BOOK/introduction/important/locale-issues.xml
===================================================================
--- trunk/BOOK/introduction/important/locale-issues.xml	2005-12-29 03:56:17 UTC (rev 5499)
+++ trunk/BOOK/introduction/important/locale-issues.xml	2005-12-29 05:52:18 UTC (rev 5500)
@@ -9,8 +9,8 @@
   <?dbhtml filename="locale-issues.html"?>
 
   <sect1info>
-    <othername>$LastChangedBy:$</othername>
-    <date>$Date:$</date>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
   </sect1info>
 
   <title>Locale Related Issues</title>
@@ -35,11 +35,30 @@
       <title>List of Packages with Locale Related Issues</title>
 
       <listitem>
+        <para><xref linkend="locale-mc"/></para>
+      </listitem>
+      <listitem>
         <para><xref linkend="locale-unzip"/></para>
       </listitem>
 
     </itemizedlist>
 
+    <sect3 id="locale-mc" xreflabel="MC-&mc-version;">
+
+      <title><xref linkend="mc"/></title>
+
+      <para>This package makes the assumption that <quote>characters</quote>
+      and <quote>bytes</quote> are the same thing. This is not true in UTF-8
+      based locales. Due to this assumption <application>MC</application> will
+      incorrectly position characters on the screen. After the cursor is moved
+      a bit the screen becomes totally unreadable, as illustrated on
+      <ulink url="http://anduin.linuxfromscratch.org/files/BLFS/mc-bad.png">this
+      screenshot</ulink> (taken in a ru_RU.UTF-8 locale). Additionally, input
+      of non-ASCII characters in the editor is impossible, even after selecting
+      <quote>Other 8-bit</quote> encoding from the menu.</para>
+
+    </sect3>
+
     <sect3 id="locale-unzip" xreflabel="UnZip-&unzip-version;">
 
       <title><xref linkend="unzip"/></title>

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2005-12-29 03:56:17 UTC (rev 5499)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2005-12-29 05:52:18 UTC (rev 5500)
@@ -45,9 +45,18 @@
       <para>December 29th, 2005</para>
       <itemizedlist>
         <listitem>
+          <para>[randy] - Added a caution note to the MC instructions
+          about the UTF-8 related issues.</para>
+        </listitem>
+        <listitem>
+          <para>[randy] - Added a caution note to the UnZip instructions
+          about the locale related issues.</para>
+        </listitem>
+        <listitem>
           <para>[randy] - Added new section 'Locale Related Issues' to Chapter
           2, 'Important Information', thanks to Alexander Patrakov for
-          contributing the text for this page.</para>
+          contributing the text for this page. The page is very incomplete and
+          many more packages with locale related issues will be added.</para>
         </listitem>
       </itemizedlist>
     </listitem>




More information about the blfs-book mailing list