26284ff627
By default, w3m puts all of its data in the `~/.w3m/` directory (creating it as necessary). This was not configurable in any way. This commit adds some quick reconfigurability -- when the "W3M_DIR" environment variable is set, w3m will use that location instead. The default location is unchanged. Fixes #130.
770 lines
16 KiB
HTML
770 lines
16 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<style>
|
|
span.mono {
|
|
font-family:mono;
|
|
}
|
|
</style>
|
|
<meta http-equiv=content-type content="text/html;charset=US-ASCII">
|
|
<title>W3M FAQ</title>
|
|
</head>
|
|
<body>
|
|
<h1 align="center">
|
|
Frequently Asked Questions and Answers about w3m
|
|
</h1>
|
|
<p align="right">
|
|
Akinori Ito <aito@fw.ipsj.or.jp><br>
|
|
Corrected by Tom Berger <tom.be@gmx.net>
|
|
</p>
|
|
<h2 id="index">
|
|
<u>
|
|
Index
|
|
</u>
|
|
</h2>
|
|
<ul>
|
|
<li>
|
|
<a href="#general">
|
|
<b>
|
|
General Questions, How to Get It, Required Environment
|
|
</b>
|
|
</a>
|
|
</li>
|
|
<ul>
|
|
<li>
|
|
<b>
|
|
How do I pronounce <q>w3m</q>?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
Why is it called <q>w3m</q>?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
On which platforms does w3m work?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
Where can I get more information about w3m?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
Is there a mailing list for w3m?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
Are there any binary distributions?
|
|
</b>
|
|
</li>
|
|
</ul>
|
|
<li>
|
|
<a href="#install">
|
|
<b>
|
|
Compile and Install
|
|
</b>
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="#command">
|
|
<b>
|
|
Options, Commands, Usage
|
|
</b>
|
|
</a>
|
|
</li>
|
|
<ul>
|
|
<li>
|
|
<b>
|
|
w3m quits if started without parameters. What's wrong?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
w3m starts with black characters on a black background. How do
|
|
I change this?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
Does w3m support colors?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
Does w3m support monochrome displays?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
How do I shift the display?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
How do I move between hyperlinks?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
Graphical browsers display a word red, but w3m doesn't. Why?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
How do I change the colors for hyperlinks, images and form fields?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
w3m doesn't seem to use the variable EDITOR. Why?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
How do I quit a search or URL text input?
|
|
</b>
|
|
</li>
|
|
</ul>
|
|
<li>
|
|
<a href="#www">
|
|
<b>
|
|
Questions about WWW usage
|
|
</b>
|
|
</a>
|
|
</li>
|
|
<ul>
|
|
<li>
|
|
<b>
|
|
How do I fill in forms with w3m?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
Seems like w3m is slower than some other browsers. Why?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
Loading time doesn't decrease when loading a previously seen
|
|
page.
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
How do I download a linked file?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
How do I specify a proxy server?
|
|
</b>
|
|
</li>
|
|
<!-- deleted, see mail dated Mon, 04 Apr 2016 20:50:27 +0900 (JST)
|
|
from Tatsuya Kinoshita <tats@debian.org>
|
|
<li>
|
|
<b>
|
|
w3m freezes when I invoke an external browser.
|
|
</b>
|
|
</li>
|
|
-->
|
|
<li>
|
|
<b>
|
|
How do I change the default image viewer?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
How do I enter a URL?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
w3m appends a URL to the former one even when I clear the line
|
|
with <span class="mono">CTRL-u</span>. What should I do?
|
|
</b>
|
|
</li>
|
|
</ul>
|
|
<li>
|
|
<a href="#other">
|
|
<b>
|
|
Miscellaneous
|
|
</b>
|
|
</a>
|
|
</li>
|
|
<ul>
|
|
<li>
|
|
<b>
|
|
What is w3m's configuration file?
|
|
</b>
|
|
</li>
|
|
<li>
|
|
<b>
|
|
What are these w3mxxxx files in my ~/.w3m directory for?
|
|
</b>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<h2 id="general">
|
|
<u>
|
|
General Questions, How to Get It, Required Environment
|
|
</u>
|
|
</h2>
|
|
<dl>
|
|
<dt>
|
|
<b>
|
|
How do I pronounce <q>w3m</q>?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
It's <q>W-three-M</q>. It doesn't rhyme with <q>pteranodon</q>.
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
Why is it called <q>w3m</q>?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
It's an abbreviation of <q>WWW-wo-Miru</q>, which is Japanese
|
|
for <q>See the WWW</q>. So in English the name of this browser
|
|
would be something like <q>stw3</q>.
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
On which platforms does w3m work?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
It runs on various versions of Unix, since version 990226 on OS/2
|
|
and since version 990303 also on MS-Windows with Cygwin32.
|
|
</p>
|
|
<p>
|
|
More recent versions have been confirmed to run on:
|
|
</p>
|
|
<ul>
|
|
<li>
|
|
SunOS 4.1.x
|
|
</li>
|
|
<li>
|
|
HP-UX 9.x, 10.x
|
|
</li>
|
|
<li>
|
|
Solaris 2.5.x, 2.6, 8
|
|
</li>
|
|
<li>
|
|
Linux 2.0.1 to 3.17
|
|
</li>
|
|
<li>
|
|
FreeBSD 2.2.8, 3.1, 3.2, 4.6
|
|
</li>
|
|
<li>
|
|
NetBSD/macppc, m68k
|
|
</li>
|
|
<li>
|
|
EWS4800 Rel.12.2 Rev.A
|
|
</li>
|
|
<li>
|
|
Digital UNIX: v3.2D, v4.0D
|
|
</li>
|
|
<li>
|
|
IRIX 5.3, IRIX 6.5
|
|
</li>
|
|
<li>
|
|
OS/2 with emx
|
|
</li>
|
|
<li>
|
|
Windows 9x/NT with Cygwin32 b20.1
|
|
</li>
|
|
<li>
|
|
MS-DOS with DJGPP and WATT32 packet driver
|
|
</li>
|
|
<li>
|
|
MacOS X Server
|
|
</li>
|
|
<li>
|
|
MacOS X 10.1, 10.2
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
Where can I get more information about w3m?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
At the
|
|
<a href="http://w3m.sourceforge.net/index.en.html">English w3m
|
|
home page</a>.
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
Is there a mailing list for w3m?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
There is a mailing list for developers (w3m-dev-en). Please see
|
|
the <a href="http://w3m.sourceforge.net/index.en.html">w3m home
|
|
page</a> for details. You may also mail your comments to
|
|
<a href="mailto:aito@fw.ipsj.or.jp">the author</a>.
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
Are there any binary distributions?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
So far there are only binaries for the win/cygnus32 version.
|
|
<!--
|
|
You can get them from
|
|
<a href="http://prdownloads.sourceforge.net/w3m/">here</a>.
|
|
!-->
|
|
Contact <a href="mailto:aito@fw.ipsj.or.jp">the author</a> if you
|
|
want to contribute binaries for other platforms.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p align="right">
|
|
<i>
|
|
Up to <a href="#index">index</a>
|
|
</i>
|
|
</p>
|
|
<h2 id="install">
|
|
<u>
|
|
Compile and Install
|
|
</u>
|
|
</h2>
|
|
<p>
|
|
No problem :-)
|
|
</p>
|
|
<h2 id="command">
|
|
<u>
|
|
Options, Commands, Usage
|
|
</u>
|
|
</h2>
|
|
<dl>
|
|
<dt>
|
|
<b>
|
|
w3m quits if started without parameters. What's wrong?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
w3m is a <b>pager</b>. Therefore it just quits when invoked
|
|
without any arguments. It keeps running
|
|
</p>
|
|
<ul>
|
|
<li>
|
|
with a filename or URL as argument
|
|
</li>
|
|
<li>
|
|
with data piped from standard input
|
|
</li>
|
|
<li>
|
|
when invoked with option -B to show the bookmark file
|
|
</li>
|
|
<li>
|
|
when invoked with option -v to welcome users with a built-in page
|
|
</li>
|
|
<li>
|
|
with specified HTTP_HOME or WWW_HOME variable
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
w3m starts with black characters on a black background. How do I
|
|
change this?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
When compiled with color support, w3m assumes a white background
|
|
and therefore displays black characters.
|
|
</p>
|
|
<p>
|
|
You may either change the background color of your terminal
|
|
(e.g. with the -bg option in a xterm) or take these steps
|
|
</p>
|
|
<ol>
|
|
<li>
|
|
invoke monochrome mode of w3m with <span class="mono">w3m -M</span>
|
|
</li>
|
|
<li>
|
|
type <q>o</q> to get to the options setting panel
|
|
</li>
|
|
<li>
|
|
mark <q>Display with color</q> as <q>YES</q> and choose an
|
|
arbitrary color
|
|
</li>
|
|
<li>
|
|
click on [OK].
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
Does w3m support colors?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Yes. When you run <q>./configure</q>, answer the question
|
|
</p>
|
|
<pre>
|
|
Let's do some configurations. Choose config option among the list.
|
|
|
|
1 - Baby model (no color, no menu, no mouse, no cookie, no SSL)
|
|
2 - Little model (color, menu, no mouse, no cookie, no SSL)
|
|
3 - Mouse model (color, menu, mouse, no cookie, no SSL)
|
|
4 - Cookie model (color, menu, mouse, cookie, no SSL)
|
|
5 - Monster model (with everything; you need openSSL library)
|
|
6 - Customize
|
|
Which?
|
|
</pre>
|
|
<p>
|
|
with 2, 3, 4, or 5.
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
Does w3m support monochrome displays?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Yes. You may either
|
|
</p>
|
|
<ul>
|
|
<li>
|
|
Answer the above-mentioned <q>configure</q> question with 1,
|
|
or
|
|
</li>
|
|
<li>
|
|
Invoke w3m with the -M option, or
|
|
</li>
|
|
<li>
|
|
Type <q>o</q> within w3m to enter the options setting panel and turn
|
|
off color display mode.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
How do I shift the display?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
You can shift the display by moving the cursor to the edge of
|
|
the screen. You may also use the following commands
|
|
</p>
|
|
<ul>
|
|
<li>SHIFT_LEFT and SHIFT_RIGHT, bound to the keys <span class="mono">></span> and <span class="mono"><</span></li>
|
|
<li>SHIFT_LEFT1 and SHIFT_RIGHT1, bound to the keys <span class="mono">.</span> and <span class="mono">,</span></li>
|
|
</ul>
|
|
<p>
|
|
Another idea would be adjusting the xterm with the -geometry
|
|
option e.g. something like
|
|
</p>
|
|
<pre> xterm -geometry 110x45 -bg white -name w3m -e w3m -B</pre>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
How do I move between hyperlinks?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
|
|
You can move to the next hyperlink
|
|
using <span class="mono">TAB</span>. <span class="mono">ESC
|
|
TAB</span> moves the cursor to the previous hyperlink. (see
|
|
Section <a href="MANUAL.html#Functions" target="_blank">
|
|
Functions and Key bindings</a> of w3m's manual)
|
|
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
Graphical browsers display a word red, but w3m doesn't. Why?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
w3m doesn't support the attribute COLOR="..." of HTML. It wouldn't
|
|
be impossible to implement this, but I think it would make
|
|
documents more difficult to read.
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
How do I change the colors for hyperlinks, images and form fields?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Type <q>o</q> within w3m to get the options panel. You
|
|
can change these settings there.
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
w3m doesn't seem to use the variable EDITOR. Why?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Go to the options setting panel using the <q>o</q> key. Any
|
|
entry in the <q>Editor</q> field overrides the environment
|
|
variable.
|
|
</p>
|
|
<p>
|
|
If you want to use the editor specified by EDITOR, blank the
|
|
field and save the settings using the button [OK].
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
How do I quit a search or URL text input?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Clear input text using <span class="mono">CTRL-u</span> and hit <span class="mono">RETURN</span>.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p align="right">
|
|
<i>
|
|
Up to <a href="#index">index</a>
|
|
</i>
|
|
</p>
|
|
<h2 id="www">
|
|
<u>
|
|
Questions about WWW usage
|
|
</u>
|
|
</h2>
|
|
<dl>
|
|
<dt>
|
|
<b>
|
|
How do I fill in forms with w3m?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Form input fields are displayed in red (or reverse). Move the
|
|
cursor to them. Then, if it is
|
|
</p>
|
|
<ul>
|
|
<li>
|
|
a text input field, hit <span class="mono">RETURN</span>
|
|
put in your text on the bottom line. Press
|
|
<span class="mono">RETURN</span> again
|
|
</li>
|
|
<li>
|
|
a radiobutton or checkbox, pressing
|
|
<span class="mono">RETURN</span> changes or toggles the selection
|
|
</li>
|
|
<li>
|
|
a textarea, pressing
|
|
<span class="mono">RETURN</span> spawns an editor
|
|
</li>
|
|
<li>
|
|
a <q>submit</q> or <q>reset</q> field,
|
|
the respective action is performed.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
Seems like w3m is slower than some other browsers. Why?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
w3m renders a HTML document in two passes. Therefore it doesn't
|
|
start to display the document until it has finished reading it.
|
|
</p>
|
|
<p>
|
|
Most other browsers display the document before having read the
|
|
whole page, and therefore seem faster.
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
Loading time doesn't decrease when loading a previously seen
|
|
page.
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
w3m doesn't have its own cache. Therefore, it reads the document
|
|
from the server each time it accesses it. If possible, use a
|
|
cache server.
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
How do I download a linked file?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Use <q>a</q> (or <q>d</q> with Lynx-like keybindings) or
|
|
<span class="mono">ESC RET</span>.
|
|
If you want to download an inline image, use
|
|
<span class="mono">ESC I</span>. (see
|
|
Section <a href="MANUAL.html#Functions" target="_blank">
|
|
Functions and Key bindings</a> of w3m's manual)
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
How do I specify a proxy server?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Set the environment variables HTTP_PROXY, HTTPS_PROXY, GOPHER_PROXY
|
|
and FTP_PROXY, or use the options setting panel (<q>o</q> key). For
|
|
example, if you want to use port 8000 of proxy.example.org, specify
|
|
</p>
|
|
<pre> http://proxy.example.org:8000/</pre>
|
|
</dd>
|
|
<!-- deleted, see mail dated Mon, 04 Apr 2016 20:50:27 +0900 (JST)
|
|
from Tatsuya Kinoshita <tats@debian.org>
|
|
<dt>
|
|
<b>
|
|
w3m freezes when I invoke an external browser.
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Enter w3m's option screen using the <q>o</q> key and specify
|
|
</p>
|
|
<pre> firefox %s &</pre>
|
|
<p>
|
|
(if you are using Firefox). Note that %s is replaced with the URL
|
|
when invoking.
|
|
</p>
|
|
</dd>
|
|
-->
|
|
<dt>
|
|
<b>
|
|
How do I change the default image viewer?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
By default w3m uses xv to view images. If you want to change it
|
|
into, let's say, <q>display</q>, add the following line to
|
|
~/.w3m/mailcap or /etc/mailcap:
|
|
</p>
|
|
<pre>
|
|
image/*; display %s
|
|
</pre>
|
|
<p>
|
|
You can specify external viewers of other file types as well:
|
|
</p>
|
|
<pre>
|
|
image/*; display %s
|
|
application/postscript; ghostview %s
|
|
application/x-dvi; xdvi %s
|
|
</pre>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
How do I enter a URL?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Type <span class="mono">U</span>
|
|
</p>
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
w3m appends a URL to the former one even when I clear the line
|
|
with <span class="mono">CTRL-u</span>. What should I do?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Enter the <i>complete</i> address, e.g. http://www.slashdot.org.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p align="right">
|
|
<i>
|
|
Up to <a href="#index">index</a>
|
|
</i>
|
|
</p>
|
|
<h2 id="other">
|
|
<u>
|
|
Miscellaneous
|
|
</u>
|
|
</h2>
|
|
<dl>
|
|
<dt>
|
|
<b>
|
|
What is w3m's configuration file?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
By default, it is ~/.w3m/config.
|
|
</p>
|
|
|
|
<p>
|
|
With this file, each user can adjust w3m's behavior by changing
|
|
the values of options whose effects are described in the options
|
|
setting panel. Each line contains one option setting, consisting
|
|
of an option name and its value with a space as a separator.
|
|
</p>
|
|
|
|
<p>
|
|
If the W3M_DIR environment variable is set to the name of a
|
|
directory, w3m will store its files in that directory instead of
|
|
in ~/.w3m.
|
|
</p>
|
|
|
|
<p>Without a user-specific configuration file, w3m honours
|
|
the system wide configuration file /etc/w3m/config.
|
|
</p>
|
|
|
|
</dd>
|
|
<dt>
|
|
<b>
|
|
What are these w3mxxxx files in my ~/.w3m directory for?
|
|
</b>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
These are temporary files used by w3m when reading documents
|
|
from a WWW server. They are not cache files and are usually
|
|
deleted when w3m is terminated. If any temp files are left
|
|
behind, please remove them yourself.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p align="right">
|
|
<i>
|
|
Up to <a href="#index">index</a>
|
|
</i>
|
|
</p>
|
|
</body>
|
|
</html>
|