source: networking/textweb/lynx.xml@ 8dfc5c3

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 8dfc5c3 was 8dfc5c3, checked in by Krejzi <krejzi@…>, 7 years ago

Fix some URLs

  • Switch to https:// scheme where possible to avoid redirects
  • Unify all kernel.org, Sourceforge and GNU URLs
  • Fix python and perl module URLs to be consistent
  • Fix github provided URLs to properly download tarballs instead of vFOO.tar.gz
  • Use upstream locations for some packages or better/shorter URLs if available
  • Add https:// URLs for gnupg packages

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19022 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 10.6 KB
RevLine 
[773c358]1<?xml version="1.0" encoding="ISO-8859-1"?>
[6732c094]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[773c358]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
[783108e]7 <!ENTITY lynx-download-http "http://invisible-mirror.net/archives/lynx/tarballs/lynx&lynx-version;.tar.bz2">
8 <!ENTITY lynx-download-ftp " ">
[a45ebfa4]9 <!ENTITY lynx-md5sum "b231c2aa34dfe7ca25681ef4e55ee7e8">
[087af8c0]10 <!ENTITY lynx-size "2.5 MB">
11 <!ENTITY lynx-buildsize "31 MB">
12 <!ENTITY lynx-time "0.3 SBU">
[773c358]13]>
14
[377584f]15<sect1 id="lynx" xreflabel="Lynx-&lynx-version;">
[f9a9bb3e]16 <?dbhtml filename="lynx.html"?>
[50b8d8b]17
[f9a9bb3e]18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
[50b8d8b]22
[f9a9bb3e]23 <title>Lynx-&lynx-version;</title>
[50b8d8b]24
[f9a9bb3e]25 <indexterm zone="lynx">
26 <primary sortas="a-Lynx">Lynx</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Lynx</title>
[50b8d8b]31
[f9a9bb3e]32 <para><application>Lynx</application> is a text based web browser.</para>
[50b8d8b]33
[44a4e0a]34 &lfs80_checked;
[bc40324]35
[f9a9bb3e]36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
[740ef14]38 <listitem>
[f9a9bb3e]39 <para>Download (HTTP): <ulink url="&lynx-download-http;"/></para>
[740ef14]40 </listitem>
[f9a9bb3e]41 <listitem>
42 <para>Download (FTP): <ulink url="&lynx-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &lynx-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &lynx-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &lynx-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &lynx-time;</para>
55 </listitem>
56 </itemizedlist>
[50b8d8b]57
[a96719e]58 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
59 <itemizedlist spacing="compact">
60 <listitem>
61 <para>
[f22fa770]62 Patch to build with openssl-1.1:
[a96719e]63 <ulink url="&patch-root;/lynx-&lynx-version;-openssl_1.1.0-1.patch"/>
64 </para>
65 </listitem>
66 </itemizedlist>
67
[f9a9bb3e]68 <bridgehead renderas="sect3">Lynx Dependencies</bridgehead>
[50b8d8b]69
[f22fa770]70 <bridgehead renderas="sect4">Recommended</bridgehead>
71 <para role="recommended">
72 <xref linkend="openssl"/>
73 </para>
74
[f9a9bb3e]75 <bridgehead renderas="sect4">Optional</bridgehead>
[f42801c]76 <para role="optional">
[f22fa770]77 <xref linkend="gnutls"/> (experimental, to replace openssl),
[f42801c]78 <xref linkend="zip"/>,
79 <xref linkend="unzip"/>,
80 an <xref linkend="server-mail"/> (that provides a <command>sendmail</command> command), and
81 <xref linkend='sharutils'/> (for a <command>uudecode</command> program)
82 </para>
[50b8d8b]83
[c22b9f4]84<!-- Attempt to utilize S-Lang (- -with-screen=slang) leads to a build failure -->
85
[061ec9d]86 <para condition="html" role="usernotes">User Notes:
[6c42d4e]87 <ulink url="&blfs-wiki;/Lynx"/></para>
[061ec9d]88
[f9a9bb3e]89 </sect2>
[50b8d8b]90
[f9a9bb3e]91 <sect2 role="installation">
92 <title>Installation of Lynx</title>
[a96719e]93 <para>
[f22fa770]94 Apply a patch to build <application>Lynx</application> with openssl-1.1:
[a96719e]95 </para>
96
[a4a3fc9]97<screen><userinput>patch -p1 -i ../lynx-&lynx-version;-openssl_1.1.0-1.patch</userinput></screen>
[f9a9bb3e]98
[1065a91]99 <para>Install <application>Lynx</application> by running the following
[f9a9bb3e]100 commands:</para>
101
[ab2d4d1e]102<screen><userinput>./configure --prefix=/usr \
[597caf43]103 --sysconfdir=/etc/lynx \
104 --datadir=/usr/share/doc/lynx-&lynx-version; \
[f42801c]105 --with-zlib \
106 --with-bzlib \
[f22fa770]107 --with-ssl \
[c22b9f4]108 --with-screen=ncursesw \
109 --enable-locale-charset &amp;&amp;
[f9a9bb3e]110make</userinput></screen>
[50b8d8b]111
[d6f100c]112 <para>This package does not come with a test suite.</para>
113
[f9a9bb3e]114 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
[520d0fe]115
[597caf43]116<screen role='root'><userinput>make install-full &amp;&amp;
117chgrp -v -R root /usr/share/doc/lynx-&lynx-version;/lynx_doc</userinput></screen>
[50b8d8b]118
[f9a9bb3e]119 </sect2>
[50b8d8b]120
[f9a9bb3e]121 <sect2 role="commands">
122 <title>Command Explanations</title>
[50b8d8b]123
[597caf43]124 <para><parameter>--sysconfdir=/etc/lynx</parameter>: This parameter is
125 used so that the configuration files are located in
126 <filename class="directory">/etc/lynx</filename> instead of
127 <filename class="directory">/usr/etc</filename>.</para>
128
129 <para><parameter>--datadir=/usr/share/doc/lynx-&lynx-version;</parameter>:
130 This parameter is used so that the documentation files are installed into
131 <filename class="directory">/usr/share/doc/lynx-&lynx-version;</filename>
132 instead of
133 <filename class="directory">/usr/share/lynx_{doc,help}</filename>.</para>
[50b8d8b]134
[f9a9bb3e]135 <para><parameter>--with-zlib</parameter>: This enables support for
[1065a91]136 linking <filename class="libraryfile">libz</filename> into
[f9a9bb3e]137 <application>Lynx</application>.</para>
[50b8d8b]138
[f9a9bb3e]139 <para><parameter>--with-bzlib</parameter>: This enables support for
[1065a91]140 linking <filename class="libraryfile">libbz2</filename> into
[f9a9bb3e]141 <application>Lynx</application>.</para>
[50b8d8b]142
[f22fa770]143 <para><parameter>--with-ssl</parameter>: This enables support for
144 linking SSL into <application>Lynx</application>.</para>
145
[c22b9f4]146 <para><parameter>--with-screen=ncursesw</parameter>: This switch enables
147 the use of advanced wide-character support present in the system
148 <application>NCurses</application> library. This is needed for
149 proper display of characters and line wrapping in multibyte locales.</para>
[29f80ebc]150
[c22b9f4]151 <para><parameter>--enable-locale-charset</parameter>: This switch allows
152 <application>Lynx</application> to deduce the proper character encoding
153 for terminal output from the current locale.
[32d0e29]154 A configuration step is still needed (see below), but
[c22b9f4]155 unlike the situation without this switch, the configuration step becomes
[32d0e29]156 the same for all users (without the switch one must specify the
157 display character set explicitly). This is important for environments such
[c22b9f4]158 as a LiveCD, where the amount of system-specific configuration steps has
159 to be reduced to the minimum.</para>
160
[6e2e278d]161 <para><option>--enable-nls</option>: This switch allows
[c22b9f4]162 <application>Lynx</application> to print translated messages (such as
163 questions about cookies and SSL certificates).</para>
164
[597caf43]165 <para><option>--with-gnutls</option>: This enables experimental support
166 for linking <application>GnuTLS</application> into
[f22fa770]167 <application>Lynx</application>. Remove the
168 <parameter>--with-ssl</parameter> switch if you want to use gnutls.</para>
[50b8d8b]169
[597caf43]170 <para><command>make install-full</command>: In addition to the standard
171 installation, this target installs the documentation and help files.</para>
172
[823b1a3]173 <para><command>chgrp -v -R root
[597caf43]174 /usr/share/doc/lynx-&lynx-version;/lynx_doc</command>:
[67ca8f6]175 This command corrects the improper group ownership of installed
[32d0e29]176 documentation files.</para>
[67ca8f6]177
[597caf43]178 <!-- This was fixed in the 2.8.6 release, though it still could
179 be considered an issue by some
[67ca8f6]180 <note>
181 <para>There has been a security vulnerability identified if you enable
[597caf43]182 support for CGI links by passing the <option>-enable-cgi-links</option>
[67ca8f6]183 parameter to <command>configure</command>. See <ulink
184 url="http://seclists.org/lists/vulnwatch/2005/Oct-Dec/0041.html"/> for
185 details.</para>
186 </note>
[597caf43]187 -->
[bccbdaea]188
[f9a9bb3e]189 </sect2>
[50b8d8b]190
[f9a9bb3e]191 <sect2 role="configuration">
192 <title>Configuring Lynx</title>
193
194 <sect3 id="lynx-config">
195 <title>Config Files</title>
[50b8d8b]196
[597caf43]197 <para><filename>/etc/lynx/lynx.cfg</filename></para>
[50b8d8b]198
[f9a9bb3e]199 <indexterm zone="lynx lynx-config">
[597caf43]200 <primary sortas="e-etc-lynx-lynx.cfg">/etc/lynx/lynx.cfg</primary>
[f9a9bb3e]201 </indexterm>
[50b8d8b]202
[f9a9bb3e]203 </sect3>
[50b8d8b]204
[f9a9bb3e]205 <sect3>
206 <title>Configuration Information</title>
[50b8d8b]207
[c22b9f4]208 <para>The proper way to get the display character set is to examine the
209 current locale. However, <application>Lynx</application> does not do
[ddc9b83]210 this by default. As the <systemitem class="username">root</systemitem>
211 user, change this setting:</para>
[c22b9f4]212
[0fe2f5b]213<screen role="root"><userinput>sed -e '/#LOCALE/ a LOCALE_CHARSET:TRUE' \
214 -i /etc/lynx/lynx.cfg</userinput></screen>
[c22b9f4]215
[d37f788]216 <para>The built-in editor in <application>Lynx</application>
217 <xref linkend="locale-wrong-multibyte-characters"/>. This issue manifests
218 itself in multibyte locales, e.g., as the Backspace key not erasing
219 non-ASCII characters properly, and as incorrect data being sent to the
220 network when one edits the contents of text areas. The only solution
221 to this problem is to configure <application>Lynx</application> to
222 use an external editor (bound to the <quote>Ctrl+X e</quote> key
[ddc9b83]223 combination by default). Still as the
224 <systemitem class="username">root</systemitem> user:</para>
[0fe2f5b]225<screen role="root"><userinput>sed -e '/#DEFAULT_ED/ a DEFAULT_EDITOR:vi' \
226 -i /etc/lynx/lynx.cfg</userinput></screen>
[d37f788]227
228 <para><application>Lynx</application> handles the following values of
229 the DEFAULT_EDITOR option specially by adding cursor-positioning
230 arguments: <quote>emacs</quote>, <quote>jed</quote>,
231 <quote>jmacs</quote>, <quote>joe</quote>, <quote>jove</quote>,
[bc40324]232 <quote>jpico</quote>, <quote>jstar</quote>, <quote>nano</quote>,
233 <quote>pico</quote>, <quote>rjoe</quote>, <quote>vi</quote> (but not
[a41f643]234 <quote>vim</quote>: in order to position the cursor in
[bc40324]235 <xref linkend="vim"/>, set this option to <quote>vi</quote>).</para>
[d37f788]236
237 <para>By default, <application>Lynx</application> doesn't save cookies
[ddc9b83]238 between sessions. Again as the
239 <systemitem class="username">root</systemitem> user, change this
240 setting:</para>
[0fe2f5b]241<screen role="root"><userinput>sed -e '/#PERSIST/ a PERSISTENT_COOKIES:TRUE' \
242 -i /etc/lynx/lynx.cfg</userinput></screen>
[d37f788]243
[c22b9f4]244 <para>Many other system-wide settings such as proxies can also be set
245 in the <filename>/etc/lynx/lynx.cfg</filename> file.</para>
[50b8d8b]246
[f9a9bb3e]247 </sect3>
[50b8d8b]248
[f9a9bb3e]249 </sect2>
[50b8d8b]250
[f9a9bb3e]251 <sect2 role="content">
252 <title>Contents</title>
253
254 <segmentedlist>
255 <segtitle>Installed Program</segtitle>
256 <segtitle>Installed Libraries</segtitle>
[597caf43]257 <segtitle>Installed Directories</segtitle>
[50b8d8b]258
[f9a9bb3e]259 <seglistitem>
260 <seg>lynx</seg>
261 <seg>None</seg>
[597caf43]262 <seg>/etc/lynx and /usr/share/doc/lynx-&lynx-version;</seg>
[f9a9bb3e]263 </seglistitem>
264 </segmentedlist>
[50b8d8b]265
[f9a9bb3e]266 <variablelist>
267 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
268 <?dbfo list-presentation="list"?>
269 <?dbhtml list-presentation="table"?>
[50b8d8b]270
[f9a9bb3e]271 <varlistentry id="lynx-prog">
272 <term><command>lynx</command></term>
273 <listitem>
[1065a91]274 <para>is a general purpose, text-based, distributed information
[f9a9bb3e]275 browser for the World Wide Web.</para>
276 <indexterm zone="lynx lynx-prog">
277 <primary sortas="b-lynx">lynx</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
[50b8d8b]281
[f9a9bb3e]282 </variablelist>
283
284 </sect2>
[f45b1953]285
286</sect1>
Note: See TracBrowser for help on using the repository browser.