r6526 - in tags/6.2.0-rc1: . basicnet/textweb general/genlib general/sysutils introduction/important introduction/welcome postlfs/editors postlfs/filesystems postlfs/shells pst/ps xsoft/graphweb

randy at linuxfromscratch.org randy at linuxfromscratch.org
Sat Feb 3 08:24:33 PST 2007


Author: randy
Date: 2007-02-03 09:24:33 -0700 (Sat, 03 Feb 2007)
New Revision: 6526

Modified:
   tags/6.2.0-rc1/basicnet/textweb/links.xml
   tags/6.2.0-rc1/general.ent
   tags/6.2.0-rc1/general/genlib/glib2.xml
   tags/6.2.0-rc1/general/sysutils/mc.xml
   tags/6.2.0-rc1/general/sysutils/unzip.xml
   tags/6.2.0-rc1/introduction/important/locale-issues.xml
   tags/6.2.0-rc1/introduction/welcome/changelog.xml
   tags/6.2.0-rc1/postlfs/editors/ed.xml
   tags/6.2.0-rc1/postlfs/filesystems/xfs.xml
   tags/6.2.0-rc1/postlfs/shells/ash.xml
   tags/6.2.0-rc1/postlfs/shells/tcsh.xml
   tags/6.2.0-rc1/pst/ps/a2ps.xml
   tags/6.2.0-rc1/pst/ps/enscript.xml
   tags/6.2.0-rc1/xsoft/graphweb/dillo.xml
Log:
Merged Alex's changes from trunk r6522

Modified: tags/6.2.0-rc1/basicnet/textweb/links.xml
===================================================================
--- tags/6.2.0-rc1/basicnet/textweb/links.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/basicnet/textweb/links.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -33,7 +33,23 @@
     WWW browser. It includes support for rendering
     tables and frames, features background downloads, can display colors
     and has many other features.</para>
+    
+    <caution>
+      <para>In the text mode, <application>Links</application> cannot be
+      configured to use UTF-8 encoding for the terminal output. This
+      limitation renders <application>Links</application> useless as a
+      text-based browser in UTF-8 locales. See general discussion of this
+      type of issue in the <xref linkend="locale-not-valid-option"/> section
+      on the <xref linkend="locale-issues"/> page.</para>
 
+      <para>In the graphical mode,
+      <application>Links</application> displays text correctly even in
+      UTF-8 locales, if all characters exist in the built-in font used by
+      <application>Links</application>. Form submission in UTF-8 locales
+      is handled correctly when running in X11-based (but not framebuffer-based)
+      graphical mode.</para>
+    </caution>
+
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
@@ -132,6 +148,26 @@
       files in the <filename class="directory">~/.links</filename> directory. These
       files are created automatically when <command>links</command> is run for the
       first time.</para>
+      
+      <para>For the correct display of non-ASCII characters, <application>Links</application>
+      has to be configured through the menu (accessible by pressing the ESC key),
+      as follows:</para>
+      
+      <itemizedlist>
+        <listitem>
+          <para>If running <application>Links</application> in the text mode,
+          go to the <quote>Setup > Character set</quote> menu item and select the character
+          set that matches your locale.</para>
+        </listitem>
+        <listitem>
+          <para>Optionally, go to the <quote>Setup > Language</quote> menu
+          and select the user interface language.</para>
+        </listitem>
+        <listitem>
+          <para>Finally, select the <quote>Setup > Save options</quote>
+          menu item.</para>
+        </listitem>
+      </itemizedlist>
 
     </sect3>
 

Modified: tags/6.2.0-rc1/general/genlib/glib2.xml
===================================================================
--- tags/6.2.0-rc1/general/genlib/glib2.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/general/genlib/glib2.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -102,6 +102,7 @@
 
       <para>By default, <application>GLib</application> assumes that all
       filenames are in the UTF-8 charset. See the <xref
+      linkend="locale-wrong-filename-encoding"/> section of the <xref
       linkend="locale-issues"/> page for more details on this kind of
       issue. In order to tell GLib and applications that use it
       that filenames are in the default locale encoding, set the variable

Modified: tags/6.2.0-rc1/general/sysutils/mc.xml
===================================================================
--- tags/6.2.0-rc1/general/sysutils/mc.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/general/sysutils/mc.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -76,7 +76,8 @@
     content corruption similar to what is depicted in
     <ulink url="&files-anduin;/mc-bad.png">this screenshot</ulink>
     (taken in the ru_RU.UTF-8 locale). For a general discussion of this type
-    of issue, see the <xref linkend="locale-issues"/> page. The Debian patch
+    of issue, see the <xref linkend="locale-wrong-multibyte-characters"/>
+    section of the <xref linkend="locale-issues"/> page. The Debian patch
     mostly fixes this issue, and adds support for recoding remote FTP
     filenames. Debian also fixed 64-bit issues, rare segfaults in
     <command>mcedit</command>, and improved syntax highlighting.</para>

Modified: tags/6.2.0-rc1/general/sysutils/unzip.xml
===================================================================
--- tags/6.2.0-rc1/general/sysutils/unzip.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/general/sysutils/unzip.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -42,7 +42,9 @@
       <para>The <application>UnZip</application> package has some locale
       related issues. See the discussion below in
       <xref linkend="unzip-locale-issues"/>. A more general
-      discussion of these problems can be found on the
+      discussion of these problems can be found in the
+      <xref linkend="locale-assumed-encoding"/>
+      section of the
       <xref linkend="locale-issues"/> page.</para>
     </caution>
 

Modified: tags/6.2.0-rc1/general.ent
===================================================================
--- tags/6.2.0-rc1/general.ent	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/general.ent	2007-02-03 16:24:33 UTC (rev 6526)
@@ -3,11 +3,11 @@
 $Date$
 -->
 
-<!ENTITY day          "31">                   <!-- Always 2 digits -->
-<!ENTITY month        "01">                   <!-- Always 2 digits -->
+<!ENTITY day          "03">                   <!-- Always 2 digits -->
+<!ENTITY month        "02">                   <!-- Always 2 digits -->
 <!ENTITY year         "2007">
 <!ENTITY version      "6.2.0-rc1">
-<!ENTITY releasedate  "January &day;st, &year;">
+<!ENTITY releasedate  "February &day;rd, &year;">
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
 <!ENTITY blfs-version "6.2.0-rc1">                  <!-- svn|[release #] -->
 <!ENTITY lfs-version  "6.2">          <!-- version|stable|testing|unstable|development] -->

Modified: tags/6.2.0-rc1/introduction/important/locale-issues.xml
===================================================================
--- tags/6.2.0-rc1/introduction/important/locale-issues.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/introduction/important/locale-issues.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -213,7 +213,7 @@
   </sect2>
 
   <sect2 id="locale-wrong-multibyte-characters"
-         xreflabel="Wrong Multibyte Characters">
+         xreflabel="Breaks Multibyte Characters">
 
     <title>The Program Breaks Multibyte Characters or Doesn't Count
     Character Cells Correctly</title>

Modified: tags/6.2.0-rc1/introduction/welcome/changelog.xml
===================================================================
--- tags/6.2.0-rc1/introduction/welcome/changelog.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/introduction/welcome/changelog.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -42,9 +42,17 @@
 -->
 
     <listitem>
-      <para>January 31st, 2007</para>
+      <para>February 2nd, 2007</para>
       <itemizedlist>
         <listitem>
+          <para>[alexander] - Added CUPS and LPRng as recommended dependencies
+          of a2ps.</para>
+        </listitem>
+        <listitem>
+          <para>[alexander] - Added some caution boxes for packages that
+          are not going to work in multibyte locales.</para>
+        </listitem>
+        <listitem>
           <para>[bdubbs] - Updated to Koffice-1.6.1.</para>
         </listitem>
         <listitem>
@@ -53,12 +61,47 @@
           to kdebindings to reduce build time by a factor of five thanks
           to Dan Nicholson.</para>
         </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
+      <para>February 1st, 2007</para>
+      <itemizedlist>
         <listitem>
+          <para>[randy] - Changed the references of polypaudio to the new
+          project name of PulseAudio, also updated the URL.</para>
+        </listitem>
+        <listitem>
+          <para>[randy] - Fixed broken URL for the "Why LD_LIBRARY_PATH is
+          bad" site in the Beyond BLFS page.</para>
+        </listitem>
+        <listitem>
+          <para>[randy] - Fixed broken download URLs in the ISO Codes
+          instructions.</para>
+        </listitem>
+        <listitem>
+          <para>[randy] - Enabled the D-BUS FTP download URL.</para>
+        </listitem>
+        <listitem>
+          <para>[randy] - Fixed broken download URL for a known working version
+          of Pyrex in the D-Bus instructions.</para>
+        </listitem>
+        <listitem>
+          <para>[randy] - Fixed broken download URLs in the HTML Tidy
+          instructions.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
+      <para>January 31st, 2007</para>
+      <itemizedlist>
+        <listitem>
           <para>[randy] - Broke out the separate sections of the Preface into
           separate XML files and added 6.2.0 release information to the
           Preface.</para>
         </listitem>
-	<listitem>
+        <listitem>
           <para>[alexander] - Upgraded GC to version 6.8 in order to fix the
           build failure with GCC-4.1.1.</para>
         </listitem>
@@ -397,7 +440,7 @@
         </listitem>
         <listitem>
           <para>[alexander] - Updated to xfsprogs-2.8.18, added notes about
-	  the lack of testsuites to xfsprogs and reiserfsprogs.</para>
+          the lack of testsuites to xfsprogs and reiserfsprogs.</para>
         </listitem>
       </itemizedlist>
     </listitem>

Modified: tags/6.2.0-rc1/postlfs/editors/ed.xml
===================================================================
--- tags/6.2.0-rc1/postlfs/editors/ed.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/postlfs/editors/ed.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -35,6 +35,18 @@
     people use. It's described here because it can be used by the patch
     program if you encounter an ed-based patch file. This happens rarely
     because diff-based patches are preferred these days.</para>
+    
+    <caution>
+      <para><application>Ed</application> determines character boundaries
+      incorrectly in multibyte locales. See the
+      <xref linkend="locale-wrong-multibyte-characters"/>
+      section of the <xref linkend="locale-issues"/> page for a more
+      general discussion of this problem. Use of <application>Ed</application>
+      in installation instructions for BLFS packages such as
+      <xref linkend="tetex"/> is not a problem, as BLFS instructions never
+      use <application>Ed</application> to modify a file containing
+      non-ASCII characters.</para>
+    </caution>
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: tags/6.2.0-rc1/postlfs/filesystems/xfs.xml
===================================================================
--- tags/6.2.0-rc1/postlfs/filesystems/xfs.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/postlfs/filesystems/xfs.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -324,8 +324,8 @@
         <term><filename class='libraryfile'>libhandle.so</filename></term>
         <listitem>
           <para>contains XFS-specific functions that provide a way to perform
-	  certain filesystem  operations without using a file descriptor to
-	  access filesystem objects.</para>
+          certain filesystem  operations without using a file descriptor to
+          access filesystem objects.</para>
           <indexterm zone="xfs libhandle">
             <primary sortas="c-libhandle">libhandle.so</primary>
           </indexterm>

Modified: tags/6.2.0-rc1/postlfs/shells/ash.xml
===================================================================
--- tags/6.2.0-rc1/postlfs/shells/ash.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/postlfs/shells/ash.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -38,6 +38,13 @@
     requirements compared to the other <command>sh</command>-compliant
     shells.</para>
 
+    <caution>
+      <para><application>Ash</application> has problems with command line
+      editing in multibyte locales. The issue is discussed in more detail
+      in the <xref linkend="locale-wrong-multibyte-characters"/> section
+      of the <xref linkend="locale-issues"/> page.</para>
+    </caution>
+
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>

Modified: tags/6.2.0-rc1/postlfs/shells/tcsh.xml
===================================================================
--- tags/6.2.0-rc1/postlfs/shells/tcsh.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/postlfs/shells/tcsh.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -35,6 +35,13 @@
     for those who prefer C syntax to that of the <command>bash</command> shell,
     and also because some programs require the C shell in order to perform
     installation tasks.</para>
+    
+    <caution>
+      <para><application>Tcsh</application> has problems with command line
+      editing in multibyte locales. The issue is discussed in more detail
+      in the <xref linkend="locale-wrong-multibyte-characters"/> section
+      of the <xref linkend="locale-issues"/> page.</para>
+    </caution>
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: tags/6.2.0-rc1/pst/ps/a2ps.xml
===================================================================
--- tags/6.2.0-rc1/pst/ps/a2ps.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/pst/ps/a2ps.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -33,6 +33,16 @@
     in the background and primarily by printing scripts to convert almost
     every input format into PostScript output. The application's name
     expands appropriately to "all to PostScript".</para>
+    
+    <caution>
+      <para><application>a2ps</application> cannot convert UTF-8 encoded
+      text to PostScript. The issue is discussed in detail in the
+      <xref linkend="locale-not-valid-option"/> section of the
+      <xref linkend="locale-issues"/> page.
+      The solution is to use <xref linkend="paps"/>, instead of
+      <application>a2ps</application>, for converting
+      UTF-8 encoded text to PostScript.</para>
+    </caution>
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
@@ -66,6 +76,12 @@
 
     <bridgehead renderas="sect3">a2ps Dependencies</bridgehead>
 
+    <bridgehead renderas="sect4">Recommended</bridgehead>
+    <para role="recommended"><xref linkend="cups"/> or <xref linkend="LPRng"/>
+    (otherwise, <application>a2ps</application> will use the
+    <command>cat >/dev/lp0</command> command instead of <command>lpr</command>
+    for sending its output to the printer)</para>
+
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional"><xref linkend="x-window-system"/>,
     <xref linkend="psutils"/>,

Modified: tags/6.2.0-rc1/pst/ps/enscript.xml
===================================================================
--- tags/6.2.0-rc1/pst/ps/enscript.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/pst/ps/enscript.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -36,6 +36,16 @@
     <para><application>Enscript</application> converts ASCII text files
     to PostScript, HTML, RTF, ANSI and overstrikes.</para>
 
+    <caution>
+      <para><application>Enscript</application> cannot convert UTF-8 encoded
+      text to PostScript. The issue is discussed in detail in the
+      <xref linkend="locale-not-valid-option"/> section of the
+      <xref linkend="locale-issues"/> page.
+      The solution is to use <xref linkend="paps"/>, instead of
+      <application>Enscript</application>, for converting
+      UTF-8 encoded text to PostScript.</para>
+    </caution>
+
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>

Modified: tags/6.2.0-rc1/xsoft/graphweb/dillo.xml
===================================================================
--- tags/6.2.0-rc1/xsoft/graphweb/dillo.xml	2007-02-03 16:06:32 UTC (rev 6525)
+++ tags/6.2.0-rc1/xsoft/graphweb/dillo.xml	2007-02-03 16:24:33 UTC (rev 6526)
@@ -37,6 +37,12 @@
     fast and so is useful on older, slower machines. It supports downloads
     and can support cookies.</para>
 
+    <caution>
+      <para><application>Dillo</application> always interprets web pages
+      as if they had the ISO-8859-1 encoding. Thus, it is useless
+      for reading non-English web pages.</para>
+    </caution>
+
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
@@ -80,12 +86,6 @@
   <sect2 role="installation">
     <title>Installation of Dillo</title>
 
-    <note>
-      <para>Dillo has no mechanism of character set selection and always
-      uses iso8859-1. If this character set is not appropriate, replace
-      all occurrences of iso8859-1 to the desired character set in
-      <filename>src/dw_style.c</filename>.</para>
-    </note>
 
     <para>Support for secure connections is considered experimental by
     <application>Dillo</application>'s author. If you want the optional HTTPS




More information about the blfs-book mailing list