On Fri, Mar 07, at 10:11 Alexander E. Patrakov wrote:
> Ag. D. Hatzimanikas wrote:
> > wget 
> > ftp://ftp.ntua.gr/pub/linux/gentoo/distfiles/links-2.1pre33-utf8.diff.bz2
> > # <ESC> -> Setup -> Terminal Options and check the "UTF-8 I/O" box
> > # <ESC> -> Setup -> Character Set and choose  KOI8-RU
> > # and while you have links running
> > g
> > www.in.gr
> > # <ESC> -> Setup -> Character Set and choose "ISO 8859-7"
> > ------>%----
> > 
> > Also entering text in web forms seems to work with an exception 
> > (I can't get an "μ", I take "υ" instead in VT mode).
> 
> Bug in one of the programs called by the "console" bootscript, because the 
> key 
> doesn't produce the correct character even in bash command line.
> 
> This seems to work for Russian, thanks for finding this patch! However,
> 
> 1) We have to document what the user should set the "Character set" option 
> to--probably it is a 8-bit character set that contains all characters that 
> links 
> is supposed to display.
> 
> 2) This doesn't work for Chinese, because there is no such character set (but 
> this is not a regression as compared to unpatched links).
> 
> 3) Filling in the forms still doesn't work in framebuffer-based graphical 
> mode.

I moved the (text) block in the cautions tag below the recommended patch
with a small addition (your recommendations), taking as prototype the
mc.xml page with a similar issue.

Please review.

-- 
http://wiki.linuxfromscratch.org/blfs/wiki/Hacking
Index: basicnet/textweb/links.xml
===================================================================
--- basicnet/textweb/links.xml  (revision 7211)
+++ basicnet/textweb/links.xml  (working copy)
@@ -34,22 +34,6 @@
     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>
@@ -72,6 +56,36 @@
       </listitem>
     </itemizedlist>
 
+    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
+    <itemizedlist spacing='compact'>
+      <listitem>
+        <para>Recommended patch: <ulink
+          url="&gentoo-ftp-repo;/links-&Links-version;-utf8.diff.bz2"/></para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Do I Need the Patch and do I have to enable
+    graphics support?</bridgehead>
+
+      <para>In the text mode, <application>Links</application> cannot be
+      configured to use UTF-8 encoding for the terminal input/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.
+      The patch fixes all these issues with an exception of Chinese locale,
+      where there isn't available a character set.
+      Note: You have to check the "UTF-8 I/O" box in "Terminal options" and
+      set the character set (probably a 8-bit) in the Setup menu.
+      </para>
+
+      <para>In 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>
+
     <bridgehead renderas="sect3">Links Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
@@ -95,11 +109,19 @@
 
   <sect2 role="installation">
     <title>Installation of Links</title>
+   
+   <para>If desired apply the patch:</para>
 
-    <para>Install <application>Links</application> by running the following
+<screen><userinput>bzcat ../links-&Links-version;-utf8.diff.bz2 | patch -p1 
&amp;&amp;
+cd intl &amp;&amp;
+./gen-intl &amp;&amp; ./synclang &amp;&amp;
+cd ..
+</userinput></screen>
+   
+   <para>Install <application>Links</application> by running the following
     commands:</para>
 
-<screen><userinput>./configure --prefix=/usr --enable-graphics &amp;&amp;
+<screen><userinput>./configure --prefix=/usr &amp;&amp;
 make</userinput></screen>
 
     <para>This package does not come with a test suite.</para>
@@ -115,7 +137,10 @@
 
   <sect2 role="commands">
     <title>Command Explanations</title>
-
+    
+    <para><command>./gen-intl &amp;&amp; ./synclang</command>: These commands
+    regenerate the languages table.</para>
+    
     <para><option>--enable-graphics</option>: This switch enables support
     for graphics mode. You will either need to install the
     <application>X</application> Window System or enable frame buffer support 
in
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-dev
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to