source: archive/w3m.xml@ 22b8124

elogind
Last change on this file since 22b8124 was 22b8124, checked in by DJ Lucas <dj@…>, 2 years ago

Cleanup branch in prep for merge.

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

  • Property mode set to 100644
File size: 6.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY w3m-download-http "&sourceforge-dl;/w3m/w3m-&w3m-version;.tar.gz">
8 <!ENTITY w3m-download-ftp " ">
9 <!ENTITY w3m-md5sum "1b845a983a50b8dec0169ac48479eacc">
10 <!ENTITY w3m-size "2.1 MB">
11 <!ENTITY w3m-buildsize "26 MB">
12 <!ENTITY w3m-time "0.3 SBU">
13]>
14
15<sect1 id="w3m" xreflabel="w3m-&w3m-version;">
16 <?dbhtml filename="w3m.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>W3m-&w3m-version;</title>
24
25 <indexterm zone="w3m">
26 <primary sortas="a-W3m">W3m</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to W3m</title>
31
32 <para><application>w3m</application> is primarily a pager but it can
33 also be used as a text-mode WWW browser.</para>
34
35 &lfs84_checked;
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>Download (HTTP): <ulink url="&w3m-download-http;"/></para>
41 </listitem>
42 <listitem>
43 <para>Download (FTP): <ulink url="&w3m-download-ftp;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download MD5 sum: &w3m-md5sum;</para>
47 </listitem>
48 <listitem>
49 <para>Download size: &w3m-size;</para>
50 </listitem>
51 <listitem>
52 <para>Estimated disk space required: &w3m-buildsize;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated build time: &w3m-time;</para>
56 </listitem>
57 </itemizedlist>
58
59 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
60 <itemizedlist spacing="compact">
61 <listitem>
62 <para>
63 Required patch:
64 <ulink url="&patch-root;/w3m-&w3m-version;-bdwgc72-2.patch"/>
65 </para>
66 </listitem>
67 </itemizedlist>
68
69 <bridgehead renderas="sect3">W3m Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Required</bridgehead>
72 <para role="required"><xref linkend="gc"/></para>
73
74 <bridgehead renderas="sect4">Optional</bridgehead>
75 <para role="optional">
76 <xref linkend="gpm"/>,
77<!-- <xref linkend="openssl10"/>,-->
78 <xref linkend="imlib2"/>,
79 <xref linkend="gtk2"/>,
80 <ulink url="http://ftp.gnome.org/pub/gnome/sources/imlib/1.9/">Imlib</ulink>
81 (not recommended: obsolete, abandoned upstream,
82 <ulink url="http://bugs.debian.org/448360">buggy</ulink>, and gives no
83 additional functionality as compared to other image loading libraries),
84 <xref linkend="gdk-pixbuf"/>,
85 <xref linkend="compface"/>, and
86 <ulink url="http://packages.debian.org/unstable/text/nkf">nkf</ulink>,
87 a Mail User Agent, and
88 an External Browser
89 </para>
90
91 <para condition="html" role="usernotes">User Notes:
92 <ulink url="&blfs-wiki;/W3M"/></para>
93 </sect2>
94
95 <sect2 role="installation">
96 <title>Installation of W3m</title>
97
98 <para>Install <application>w3m</application> by running the following
99 commands:</para>
100
101<screen><userinput>patch -Np1 -i ../w3m-&w3m-version;-bdwgc72-2.patch &amp;&amp;
102sed -i 's/file_handle/file_foo/' istream.{c,h} &amp;&amp;
103sed -i 's#gdk-pixbuf-xlib-2.0#&amp; x11#' configure &amp;&amp;
104sed -i '/USE_EGD/s/define/undef/' config.h.in &amp;&amp;
105
106
107./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
108make</userinput></screen>
109
110 <para>This package does not come with a test suite.</para>
111
112 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
113
114<screen role="root"><userinput>make install &amp;&amp;
115install -v -m644 -D doc/keymap.default /etc/w3m/keymap &amp;&amp;
116install -v -m644 doc/menu.default /etc/w3m/menu &amp;&amp;
117install -v -m755 -d /usr/share/doc/w3m-&w3m-version; &amp;&amp;
118install -v -m644 doc/{HISTORY,READ*,keymap.*,menu.*,*.html} \
119 /usr/share/doc/w3m-&w3m-version;</userinput></screen>
120 </sect2>
121
122 <sect2 role="commands">
123 <title>Command Explanations</title>
124
125 <para>
126 <command>patch -p1 &lt; ../w3m-&w3m-version;-bdwgc72-2.patch</command>:
127 This patch fixes compiling w3m with GC-7.2 and above installed.
128 </para>
129
130 <para><command>sed -i 's/file_handle/file_foo/' istream.{c,h}</command>:
131 This sed renames the file_handle function to avoid a clash with a glibc
132 function that has the same name, defined in
133 /usr/include/bits/fcntl.h.</para>
134
135 <para><command>sed -i 's#gdk-pixbuf-xlib-2.0#&amp; x11#'
136 configure</command>: This sed fixes compiling <application>w3m</application>
137 using <xref linkend="gtk2"/> as its image library. It has no impact if
138 <xref linkend="gtk2"/> is not installed.</para>
139
140 <para>
141 <command>sed -i '/USE_EGD/s/define/undef/' config.h.in</command>: Allows
142 building against <application>openssl-1.1</application>.
143 </para>
144
145 <para><parameter>--sysconfdir=/etc</parameter>: This option puts the
146 configuration files in /etc.</para>
147 </sect2>
148
149 <sect2 role="configuration">
150 <title>Configuring W3m</title>
151
152 <sect3 id="w3m-config">
153 <title>Config Files</title>
154
155 <para><filename>/etc/w3m/*</filename> and
156 <filename>~/.w3m/*</filename></para>
157
158 <indexterm zone="w3m w3m-config">
159 <primary sortas="e-etc-w3m/*">/etc/w3m/*</primary>
160 </indexterm>
161
162 <indexterm zone="w3m w3m-config">
163 <primary sortas="e-AA.w3m/*">~/.w3m/*</primary>
164 </indexterm>
165 </sect3>
166 </sect2>
167
168 <sect2 role="content">
169 <title>Contents</title>
170
171 <segmentedlist>
172 <segtitle>Installed Programs</segtitle>
173 <segtitle>Installed Libraries</segtitle>
174 <segtitle>Installed Directories</segtitle>
175
176 <seglistitem>
177 <seg>w3m and w3mman</seg>
178 <seg>None</seg>
179 <seg>/usr/libexec/w3m,
180 /usr/share/w3m, and
181 /usr/share/doc/w3m-&w3m-version;</seg>
182 </seglistitem>
183 </segmentedlist>
184
185 <variablelist>
186 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
187 <?dbfo list-presentation="list"?>
188 <?dbhtml list-presentation="table"?>
189
190 <varlistentry id="w3m-prog">
191 <term><command>w3m</command></term>
192 <listitem>
193 <para>is a text based web browser and pager.</para>
194 <indexterm zone="w3m w3m-prog">
195 <primary sortas="b-w3m">w3m</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 <varlistentry id="w3mman">
201 <!-- Don't remove the extra space, it prevent a FOP warning. -->
202 <term><command>w3mman</command> </term>
203 <listitem>
204 <para>is an interface to the on-line reference manuals in
205 <command>w3m</command>.</para>
206 <indexterm zone="w3m w3mman">
207 <primary sortas="b-w3mman">w3mman</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211 </variablelist>
212 </sect2>
213</sect1>
Note: See TracBrowser for help on using the repository browser.