aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/FAQ.html983
-rw-r--r--doc/MANUAL.html2594
-rw-r--r--doc/README.func130
-rw-r--r--doc/menu.submenu2
-rw-r--r--main.c64
-rw-r--r--menu.c6
-rw-r--r--scripts/w3mhelp-funcdesc.ja.pl.in4
-rw-r--r--scripts/w3mhelp.cgi.in4
-rw-r--r--w3mhelp-lynx_en.html.in22
-rw-r--r--w3mhelp-w3m_en.html.in22
10 files changed, 2942 insertions, 889 deletions
diff --git a/doc/FAQ.html b/doc/FAQ.html
index ab95138..a113d8b 100644
--- a/doc/FAQ.html
+++ b/doc/FAQ.html
@@ -1,151 +1,423 @@
-<HTML>
-<HEAD>
-<TITLE>W3M FAQ</TITLE>
-</HEAD>
-<BODY>
-<p>&nbsp;
-<center><h1>Frequently Asked Questions and Answers about w3m</h1></center>
-<div align=right>
-Akinori Ito<br>
-aito@fw.ipsj.or.jp<br>
-Corrected by Tom Berger &lt;tom.be@gmx.net&gt;
-</div>
-<p>
-<b><center><font size=+1><u><a name="index">Index</a></u></font></center></b>
-<p>
-<br>
-<ul>
-<li><h2><a href="#general">General Questions, How to Get It, Required Environment</a></h2></li>
-<ul>
-<li><h3>How do I pronounce &quot;w3m&quot;?</h3>
-<li><h3>Why is it called &quot;w3m&quot;?</h3>
-<li><h3>On which platforms does w3m work?</h3>
-<li><h3>Where can I get more information about w3m?</h3>
-<li><h3>Is there a mailing list for w3m?</h3>
-<li><h3>Are there any binary distributions?</h3>
-</ul>
-<br>
-<li><a href="#install"><h2>Compile and Install</h2></a>
-<br>
-<li><a href="#command"><h2>Options, Commands, Usage</h2></a>
-<ul>
-<li><h3>w3m quits if started without parameters. What's wrong?</h3>
-<li><h3>w3m starts with black characters on a black screen. How do I change this?</h3>
-<li><h3>Does w3m support colours?</h3>
-<li><h3>Does w3m support monochrome display?</h3>
-<li><h3>How do I shift the display?</h3>
-<li><h3>How do I move from anchor to anchor?</h3>
-<li><h3>Netscape displays a word red, but w3m doesn't. Why?</h3>
-<li><h3>How do I change the colour of anchor-/image-/form links?</h3>
-<li><h3>w3m doesn't seem to use the variable EDITOR. Why? </h3>
-<li><h3>How do I quit a search or URL text input?</h3>
-</ul>
-<br>
-<li><a href="#www"><h2>Questions about WWW usage</h2></a>
-<ul>
-<li><h3>How do I fill in forms with w3m?</h3>
-<li><h3>Seems like w3m is slower than Netscape or Lynx. Why?</h3>
-<li><h3>Loading time doesn't decrease when loading a previously seen page</h3>
-<li><h3>How do I download a linked file?</h3>
-<li><h3>How do I specify a proxy server?</h3>
-<li><h3>w3m freezes when I invoke an external browser.</h3>
-<li><h3>How do I change the default image viewer?</h3>
-<li><h3>How do I enter a URL?</h3>
-<li><h3>w3m appends a URL to the former one despite of having cleared the line with Ctrl-u. What to do?</h3>
-</ul>
-<br>
-<li><a href="#other"><h2>Misc</a></h2>
-<ul>
-<li><h3>What is w3m's configuration file?</h3>
-<li><h3>What are these w3mxxxx files in my ~/.w3m directory for?</h3>
-</ul>
-<br>&nbsp;
-<br>
-<u><h2><a name="general">General Questions, How to Get It, Required Environment</a></h2></u>
-<br>
-<dl>
-<dt><h3>How do I pronounce &quot;w3m&quot;?</h3>
-<dd>It's &quot;W-three-M&quot;. It doesn't rhyme with &quot;pteranodon&quot;.
-<p>
-<dt><h3>Why is it called &quot;w3m&quot;?</h3>
-<dd>It's an abbreviation of &quot;WWW-wo-Miru&quot;, which is Japanese for
-&quot;See the WWW&quot;. So in English the name of this browser would be
-something like &quot;stw3&quot;.
-<p>
-<dt><h3>On which platforms does w3m work?</h3>
-<dd>It runs on various versions of Unix, since version 990226 on OS/2 and since
-version 990303 also on MS-Windows with Cygwin32.
-<br>
-Current versions have been confirmed to run on:
-<ul>
-<li>SunOS 4.1.x
-<li>HP-UX 9.x, 10.x
-<li>Solaris 2.5.x, 2.6, 8
-<li>Linux 2.0.30
-<li>FreeBSD 2.2.8, 3.1, 3.2, 4.6
-<li>NetBSD/macppc, m68k
-<li>EWS4800 Rel.12.2 Rev.A
-<li>Digital UNIX: v3.2D, v4.0D
-<li>IRIX 5.3, IRIX 6.5
-<li>OS/2 with emx
-<li>Windows 9x/NT with Cygwin32 b20.1
-<li>MS-DOS with DJGPP and WATT32 packet driver
-<li>MacOS X Server
-<li>MacOS X 10.1, 10.2
-</ul>
-<dt><h3>Where can I get more information about w3m?</h3>
-<dd>At the <a href="http://w3m.sourceforge.net/index.en.html">English w3m home page</a>.
-<dt><h3>Is there a mailing list for w3m?</h3>
-<dd>There is a mailing list for developpers (w3m-dev-en). Please see
-<a href="http://w3m.sourceforge.net/index.en.html">w3m page</a>
-for details. You may also mail your comments to <a href="mailto:aito@fw.ipsj.or.jp">the author</a>.
-<dt><h3>Are there any binary distributions?</h3>
-<dd>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.
-</dd>
-</dl>
-<br>
-<div align=right>
-<i>Up to <a href="#index">index</a></i>
-</div>
-<br>
-<u><h2><a name="install">Compile and Install</a></h2></u>
-No problem :-)
-<u><h2><a name="command">Options, Commands, Usage</a></h2></u>
-<br>
-<dl>
-<dt><h3>w3m quits if started without parameters. What's wrong?</h3>
-<dd>w3m is a <b>pager</b>. Therefore it just quits when invoked without any
-arguments. Possible arguments are:
-<ol>
-<li>A filename or an URL
-<li>Pipe from standard input
-<li>The -B option (Show bookmark file)
-<li>The -v option (visual startup)
-<li>From a specified HTTP_HOME or WWW_HOME variable
-</ol>
-<p>
-<dt><h3>w3m starts with black characters on black background. How do I change
-this?</h3>
-<dd>
-When compiled with colour support, w3m assumes a white background and therefore
-displays black characters.
-<br>
-You may either change the background colour of your terminal (e.g. with the -bg
-option in a xterm) or take these steps:
-<ul>
-<li>invoke w3m with 'w3m -M' (for monochrome),
-<li>type 'o' for getting to the options screen
-<li><b>Mark 'Display with colour' as ON</b> and choose an arbitrary colour.
-Click on [OK].
-</ul>
-<p>
-<dt><h3>Does w3m support colours?</h3>
-<dd>Yes. When you run './configure', answer the question
-<p>
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+ <head>
+ <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<br>
+ aito@fw.ipsj.or.jp<br>
+ Corrected by Tom Berger &lt;tom.be@gmx.net&gt;
+ </p>
+ <h2 id="index">
+ <u>
+ Index
+ </u>
+ </h2>
+ <ul>
+ <li>
+ <a href="#general">
+ <b>
+ General Questions, How to Get It, Required Environment
+ </b>
+ </a>
+ <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>
+ <li>
+ <a href="#install">
+ <b>
+ Compile and Install
+ </b>
+ </a>
+ </li>
+ <li>
+ <a href="#command">
+ <b>
+ Options, Commands, Usage
+ </b>
+ </a>
+ <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 from anchor to anchor?
+ </b>
+ </li>
+ <li>
+ <b>
+ Graphical browsers display a word red, but w3m doesn't. Why?
+ </b>
+ </li>
+ <li>
+ <b>
+ How do I change the color of anchor/image/form links?
+ </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>
+ <li>
+ <a href="#www">
+ <b>
+ Questions about WWW usage
+ </b>
+ </a>
+ <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>
+ <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 despite of having cleared
+ the line with Ctrl-u. What to do?
+ </b>
+ </li>
+ </ul>
+ </li>
+ <li>
+ <a href="#other">
+ <b>
+ Misc
+ </b>
+ </a>
+ <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>
+ </li>
+ </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. Possible arguments are:
+ </p>
+ <ol>
+ <li>
+ A filename or URL
+ </li>
+ <li>
+ Pipe from standard input
+ </li>
+ <li>
+ The -B option (show bookmark file)
+ </li>
+ <li>
+ The -v option (visual startup)
+ </li>
+ <li>
+ A specified HTTP_HOME or WWW_HOME variable
+ </li>
+ </ol>
+ </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>
+ <ul>
+ <li>
+ invoke w3m with <q>w3m -M</q> (for monochrome),
+ </li>
+ <li>
+ type <q>o</q> to get to the options screen
+ </li>
+ <li>
+ <b>Mark <q>Display with color</q> as ON</b> and choose an
+ arbitrary color.
+ </li>
+ <li>
+ Click on [OK].
+ </li>
+ </ul>
+ </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."
+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)
@@ -153,139 +425,310 @@ Let's do some configurations. Choose config option among the list."
4 - Cookie model (color, menu, mouse, cookie, no SSL)
5 - Monster model (with everything; you need openSSL library)
6 - Customize
-Which?
+Which?
</pre>
-<p>
-with 2,3,4 or 5.
-<p>
-<dt><h3>Does w3m support monochrome display?</h3>
-<dd>Yes. You may either
-<ol>
-<li>Answer the above mentioned 'configure' question with 1, or
-<li>Invoke w3m with the -M option, or
-<li>Type 'o' within w3m to enter the options screen and turn off colour display
-mode.
-</ol>
-<dt><h3>How do I shift the display?</h3>
-<dd>You can shift the display by moving the cursor to the edge of the screen. You
-may also use the "&gt;"/"&lt;" or "."/"," keys.
-<br>
-Another idea would be adjusting the xterm with the -geometry option (e.g.
-something like 'xterm -geometry 110x45 -bg white -name w3m -e w3m -B').
-<dt><h3>How do I move from anchor to anchor?</h3>
-<dd>You can move to the next anchor using TAB. ESC TAB moves cursor to the previous anchor.
-<p>
-<dt><h3>Netscape displays a word red, but w3m doesn't. Why?</h3>
-<dd>w3m doesn't support &lt;FONT COLOR=".."&gt; tags. It won't be impossible to implement this, but I think it would make the document more difficult to read.
-<p>
-<dt><h3>How do I change the colour of anchor-/image-/form links?</h3>
-<dd>Type 'o' within w3m to get the 'options' screen. You can change these
-settings there.
-<dt>
-<dt><h3>w3m doesn't seem to use the variable EDITOR. Why? </h3>
-<dd><dd>Go to the 'options' screen using the "o" key. Any entry in the 'Editor' field will override the environment variable.
-<br>
-If you want to use the editor specified by EDITOR blank the field and push [OK].
-<p>
-<dt><h3>How do I quit a search or URL text input?</h3>
-<dd>Clear input text using Ctrl-u and hit RETURN.
-</dd>
-</dl>
-<br>
-<div align=right>
-<i>Up to <a href="#index">index</a></i>
-</div>
-<br>
-<u><h2><a name="www">Questions about WWW usage</a></h2></u>
-<br>
-<dl>
-<dt><h3>How do I fill in forms with w3m?</h3>
-<dd>Form input fields are displayed in red (or reverse). Move the cursor to
-them and hit RETURN. Then,
-<ul>
-<li>if it is a text input field, put in your text on the bottom line,
-<li>if it is a radiobutton or checkbox, that item is selected,
-<li>if it is a textarea, an editor is spawned,
-<li>if it is 'submit' or 'reset', well, just do it.
-</ul>
-<dt><h3>Seems like w3m is slower than Netscape or Lynx. Why?</h3>
-<dd>w3m renders a HTML document in two passes. Therefore it displays the documentnot before having read the entire document.
-<br>
-Netscape or Lynx display the document before having read the whole page,
-and therefore seem faster.
-<p>
-<dt><h3>Loading time doesn't decrease when loading a previously seen page</h3>
-<dd>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>
-<dt><h3>How do I download a linked file?</h3>
-<dd>Use 'a' (or 'd' with Lynx-like keybindings) or ESC RET. If you want to download an inline image, use ESC 'I'.
-<p>
-<dt><h3>How do I specify a proxy server?</h3>
-<dd>Set the environment variables HTTP_PROXY, HTTPS_PROXY, GOPHER_PROXY and FTP_PROXY, or use the option setting panel
-("o" key). For example, if you want to use port 8000 of proxy.hogege.com, specify
-<p>
+ <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>
+ <ol>
+ <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 screen and turn
+ off color display mode.
+ </li>
+ </ol>
+ </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 <q>&gt;</q>/<q>&lt;</q> or
+ <q>.</q>/<q>,</q> keys.
+ </p>
+ <p>
+ Another idea would be adjusting the xterm with the -geometry
+ option (e.g. something like <q>xterm -geometry 110x45 -bg white
+ -name w3m -e w3m -B</q>).
+ </p>
+ </dd>
+ <dt>
+ <b>
+ How do I move from anchor to anchor?
+ </b>
+ </dt>
+ <dd>
+ <p>
+ You can move to the next anchor using TAB. ESC TAB moves the
+ cursor to the previous anchor.
+ </p>
+ </dd>
+ <dt>
+ <b>
+ Graphical browsers display a word red, but w3m doesn't. Why?
+ </b>
+ </dt>
+ <dd>
+ <p>
+ w3m doesn't support the HTML COLOR="..." attribute. 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 color of anchor/image/form links?
+ </b>
+ </dt>
+ <dd>
+ <p>
+ Type <q>o</q> within w3m to get the <q>options</q> screen. 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 <q>options</q> screen using the <q>o</q> key. Any
+ entry in the <q>Editor</q> field will override the environment
+ variable.
+ </p>
+ <p>
+ If you want to use the editor specified by EDITOR, blank the
+ field and press [OK].
+ </p>
+ </dd>
+ <dt>
+ <b>
+ How do I quit a search or URL text input?
+ </b>
+ </dt>
+ <dd>
+ <p>
+ Clear input text using Ctrl-u and hit RETURN.
+ </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 and hit RETURN. Then,
+ </p>
+ <ul>
+ <li>
+ if it is a text input field, put in your text on the bottom
+ line,
+ </li>
+ <li>
+ if it is a radiobutton or checkbox, that item is selected,
+ </li>
+ <li>
+ if it is a textarea, an editor is spawned,
+ </li>
+ <li>
+ if it is <q>submit</q> or <q>reset</q>, well, just do it.
+ </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 ESC RET.
+ If you want to download an inline image, use ESC <q>I</q>.
+ </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 option
+ setting panel (<q>o</q> key). For example, if you want to use
+ port 8000 of proxy.example.org, specify
+ </p>
<pre>
- http://proxy.hogege.com:8000/
+ http://proxy.example.org:8000/
</pre>
-<p>
-<dt><h3>w3m freezes when I invoke an external browser.</h3>
-<dd>Enter w3m's option screen using the 'o' key and specify
-<p>
+ </dd>
+ <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>
- netscape %s &
+ firefox %s &
</pre>
-<p>
-(%s is replaced with the URL when invoking).
-<p>
-<dt><h3>How do I change the default image viewer?</h3>
-<dd>By default w3m uses xv to view images. If you want to change it into, let's say, 'display', add the following line to ~/.w3m/mailcap or /etc/mailcap.
-<p>
+ <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>
+ <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>
-<dt><h3>How do I enter a URL?</h3>
-<dd>Type SHIFT-U
-<p>
-<dt><h3>w3m appends a URL to the former one despite of having cleared the line
-with Ctrl-u. What to do?</h3>
-<dd>Enter the <i>complete</i> adress, e.g. http://www.slashdot.org.
-</dd>
-</dl>
-<br>
-<div align=right>
-<i>Up to <a href="#index">index</a></i>
-</div>
-<br>
-<u><h2><a name="other">Miscellaneous</a></h2></u>
-<br>
-<dl>
-<dt><h3>What is w3m's configuration file?</h3>
-<dd>It is ~/.w3m/config.
-With this file, you can adjust w3m's behavior by changing values of options
-that are described to be varied with the option setting panel.
-Each line contains setting for one option, which is a pair of an option name
-and its value with a space as a separator.
-<p>
-<dt><h3>What are these w3mxxxx files in my ~/.w3m directory for?</h3>
-<dd>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 there remain any temp files, please remove them by yourself.
-<p>
-</dd>
-</dl>
-<br>
-<div align=right>
-<i>Up to <a href="#index">index</a></i>
-</div>
-<br>
-</BODY>
-</HTML>
+ </dd>
+ <dt>
+ <b>
+ How do I enter a URL?
+ </b>
+ </dt>
+ <dd>
+ <p>
+ Type SHIFT-U
+ </p>
+ </dd>
+ <dt>
+ <b>
+ w3m appends a URL to the former one even when I clear the line
+ with Ctrl-u. What should I do?
+ </b>
+ </dt>
+ <dd>
+ <p>
+ Enter the <i>complete</i> adress, 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>
+ It is ~/.w3m/config.
+ </p>
+ <p>
+ With this file, you can adjust w3m's behavior by changing the
+ values of options whose effects are described in the option
+ setting panel. Each line contains one option setting, consisting
+ of an option name and its value with a space as a separator.
+ </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>
diff --git a/doc/MANUAL.html b/doc/MANUAL.html
index 300e370..4b5318a 100644
--- a/doc/MANUAL.html
+++ b/doc/MANUAL.html
@@ -1,505 +1,2109 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
-<head><title>w3m manual</title>
-</head>
-<body>
-<h1>w3m MANUAL</h1>
-<div align=right>
-Akinori Ito<br>
-aito@fw.ipsj.or.jp
-</div>
-<h2>Index</h2>
-<menu>
-<li><a href="#Introduction">Introduction</a>
-<li><a href="#Options">Options</a>
-<li><a href="#Color">Document color</a>
-<li><a href="#Key:orig">Key binding</a>
-<li><a href="#Key:lynx">Lynx-like key binding</a>
-<li><a href="#Mouse">Mouse operation</a>
-<li><a href="#Key:custom">Key customization</a>
-<li><a href="#LocalCGI">Local CGI</a>
-</menu>
-
-<hr>
-<a name="Introduction"></a>
-<h2>Introduction</h2>
-w3m is a pager/text-based WWW browser. You can browse local documents and/or
-documents on the WWW using a terminal emulator.
-
-<hr>
-<a name="Options"></a>
-<h2>Options</h2>
-
-Command line usage is
-<p>
+ <head>
+ <meta http-equiv=content-type content="text/html;charset=US-ASCII">
+ <title>
+ w3m manual
+ </title>
+ </head>
+ <body>
+ <h1>w3m MANUAL</h1>
+ <div align="right">
+ Akinori Ito<br>
+ aito@fw.ipsj.or.jp
+ </div>
+ <h2>Index</h2>
+ <ul>
+ <li>
+ <a href="#Introduction">
+ Introduction
+ </a>
+ </li>
+ <li>
+ <a href="#Options">
+ Options
+ </a>
+ </li>
+ <li>
+ <a href="#Color">
+ Document colors
+ </a>
+ </li>
+ <li>
+ <a href="#Key:orig">
+ Key bindings
+ </a>
+ </li>
+ <li>
+ <a href="#Key:lynx">
+ Lynx-like key bindings
+ </a>
+ </li>
+ <li>
+ <a href="#Mouse">
+ Mouse operation
+ </a>
+ </li>
+ <li>
+ <a href="#Key:custom">
+ Key customization
+ </a>
+ </li>
+ <li>
+ <a href="#LocalCGI">
+ Local CGI
+ </a>
+ </li>
+ </ul>
+ <hr>
+ <h2 id="Introduction">
+ Introduction
+ </h2>
+<!--
+ TODO: import improved phrasings from manpage
+!-->
+ <p>
+ w3m is a pager/text-based WWW browser. You can browse local
+ documents and/or documents on the WWW using a terminal emulator.
+ </p>
+ <hr>
+ <h2 id="Options">
+ Options
+ </h2>
+ <p>
+ Command line usage is
+ </p>
<pre>
w3m [options] [file|URL]
</pre>
-<P>
-If you specify filenames/URLs on command line, these documents are displayed.
-If you specify nothing, w3m reads a document from standard input and display it.
-If no filename and/or URLs are specified and standard input is tty, w3m terminates
-without displaying anything.
-
-<p>
-Options are as follows:
-<dl>
-<dt>+&lt;line number&gt;
-<dd>Move to the specified line.
-<dt>-t width
-<dd>Specify tab width. Default is 8.
-<dt>-r
-<dd>When displaying text/plain document, prohibit emphasis using backspace.
-If you don't specify this option,
-``A^H_'' is interpreted as underlined character and ``A^HA'' as a bold character.
-<dt>-l number
-<dd>Specify line number preserved internally when reading text/plain document
-fron standard input. Default is 10000.
-<dt>-O charset
-<dd>Specify display/output charset.
-<dt>-I charset
-<dd>Specify document charset.
-<dt>-T type
-<dd>Specify document type. Without this option, document type
-is determined from extension of a file. If the determination
-fails, the document is regarded as text/plain.
-<p>
-Example:<br>
-Read HTML document from standard input and display it
+ <p>
+ If you specify filenames/URLs on the command line, these documents
+ are displayed. If you specify nothing, w3m will read a document
+ from standard input and display it. If it doesn't find a document
+ there either then normally w3m will terminate.
+ </p>
+ <p>
+ Options include:
+ <p>
+ <dl>
+ <dt>
+ +<i>number</i>
+ </dt>
+ <dd>
+ <p>
+ Move to the specified line-number.
+ </p>
+ </dd>
+ <dt>
+ -t <i>width</i>
+ </dt>
+ <dd>
+ <p>
+ Specify tab width. Default is 8.
+ </p>
+ </dd>
+ <dt>
+ -r
+ </dt>
+ <dd>
+ <p>
+ When displaying text/plain documents, prohibit emphasis using
+ backspace. If you don't specify this option, <q>A^H_</q> is
+ interpreted as an underlined <q>A</q> and <q>A^HA</q> as a bold
+ <q>A</q>.
+ </p>
+ </dd>
+ <dt>
+ -l <i>number</i>
+ </dt>
+ <dd>
+ <p>
+ Specify the number of lines that should be cached while reading a
+ text/plain document from standard input. Default is 10,000.
+ </p>
+ </dd>
+ <dt>
+ -O <i>charset</i>
+ </dt>
+ <dd>
+ <p>
+ Specify display/output charset.
+ </p>
+ </dd>
+ <dt>
+ -I <i>charset</i>
+ <dt>
+ <dd>
+ <p>
+ Specify document charset.
+ </p>
+ </dd>
+ <dt>
+ -T <i>type</i>
+ </dt>
+ <dd>
+ <p>
+ Specify document type. Without this option, document type is
+ determined from the extension of a file. If the determination
+ fails, the document is regarded as text/plain. For example:
+ </p>
+ <p>
+ Read HTML document from standard input and display it
+ </p>
<pre>
- cat hoge.html | w3m -T text/html
+ cat example.html | w3m -T text/html
</pre>
-<p>
-Display HTML source
+ <p>
+ Display HTML source
+ </p>
<pre>
- w3m -T text/plain hoge.html
+ w3m -T text/plain example.html
</pre>
-<dt>-m
-<dd>Display document with Internet message mode.
-With this option, w3m determines document type from header information.
-It is useful when reading E-mail or NetNews messages.
-<dt>-v
-<dd>visual startup mode.
-<dt>-B
-<dd>Show the bookmark.
-<dt>-bookmark file
-<dd>Specify bookmark file.
-<dt>-M
-<dd>Monochrome display mode.
-<dt>-F
-<dd>Automatically render frame.
-<dt>-s
-<dd>Squeeze blank lines.
-<dt>-X
-<dd>Upon exit, do not display preserved screen.
-<dt>-W
-<dd>Toggle wrap search mode.
-<dt>-o option=value
-<dd>Specify option. The option names and values are
-same as that appears in ~/.w3m/config.
-<dt>-cookie
-<dd>Process cookies.
-<dt>-no-cookie
-<dd>Don't process cookies.
-<dt>-num
-<dd>Show linenumber.
-<dt>-dump
-<dd>Read document specified by URL and dump formatted text into standard
-output. The width of the document become 80. This width can be overridden
-with -cols option.
-<dt>-cols width
-<dd>Specify document width. Used with -dump option.
-<dt>-ppc count
-<dd> Specify the number of pixels per character (default 8.0). Larger
- values will make tables narrower.
-<dt>-dump_source
-<dd>Read document specified by URL and dump the source.
-<dt>-dump_head
-<dd>Read document specified by URL and dump headers.
-<dt>-dump_both
-<dd>Read document specified by URL and dump headers and the source.
-<dt>-dump_extra
-<dd>Read document specified by URL and dump extra informations, headers and the source.
-<dt>-post file
-<dd>use POST method with file content.
-<dt>-header string
-<dd>insert string as a header.
-<dt>-no-proxy
-<dd>Don't use proxy server.
-<dt>-no-graph
-<dd>Use ASCII character to draw frames.
-<dt>-no-mouse
-<dd>Don't activate mouse.
-<dt>-config file
-<dd>specify config file.
-</dl>
-
-<hr>
-<a name="Color"></a>
-<h2>Document color</h2>
-
-Links and images are displayed as follows.
-<div align="center">
-<table border="1">
-<tr><th>&nbsp;</th><th>Color mode</th><th>Monochrome mode</th></tr>
-<tr><td>links</td><td>blue</td><td>underline</td></tr>
-<tr><td>inline images</td><td>green</td><td>reverse</td></tr>
-<tr><td>form input</td><td>red</td><td>reverse</td></tr>
-</table>
-</div>
-These colors can be customized using option setting command "o".
-
-<hr>
-<a name="Key:orig"></a>
-<h2>Key binding</h2>
-
-After invocation, you can operate w3m by one-character commands from
-the keyboard.
-<P>
-Here's the original key-binding table. If you are using Lynx-like key
-bindings, see <a href="#Key:lynx">the Lynx-like key binding</a>.
-
-<H3>Page/Cursor motion</H3>
-<table>
-<TR><TD WIDTH=100>SPC,C-v<TD>Forward page
-<TR><TD>b,ESC v<TD>Backward page
-<TR><TD>l,C-f<TD>Cursor right
-<TR><TD>h,C-b<TD>Cursor left
-<TR><TD>j,C-n<TD>Cursor down
-<TR><TD>k,C-p<TD>Cursor up
-<TR><TD>J<TD>Roll up one line
-<TR><TD>K<TD>Roll down one line
-<TR><TD>^,C-a<TD>Go to the beginning of line
-<TR><TD>$,C-e<TD>Go to the end of line
-<TR><TD>w<TD>Go to next word
-<TR><TD>W<TD>Go to previous word
-<TR><TD>&gt;<TD>Shift screen right
-<TR><TD>&lt;<TD>Shift screen left
-<TR><TD>.<TD>Shift screen one column right
-<TR><TD>,<TD>Shift screen one column left
-<TR><TD>g,M-&lt;<TD>Go to the first line
-<TR><TD>G,M-&gt;<TD>Go to the last line
-<TR><TD>ESC g<TD>Go to specified line
-<TR><TD>Z<TD>Move to the center line
-<TR><TD>z<TD>Move to the center column
-<TR><TD>TAB<TD>Move to next hyperlink
-<TR><TD>C-u,ESC TAB<TD>Move to previous hyperlink
-<TR><TD>[<TD>Move to the first hyperlink
-<TR><TD>]<TD>Move to the last hyperlink
-</table>
-
-<H3>Hyperlink operation</H3>
-<table>
-<TR><TD WIDTH=100>RET<TD>Follow hyperlink
-<TR><TD>a, ESC RET<TD>Save link to file
-<TR><TD>u<TD>Peek link URL
-<TR><TD>i<TD>Peek image URL
-<TR><TD>I<TD>View inline image
-<TR><TD>ESC I<TD>Save inline image to file
-<TR><TD>:<TD>Mark URL-like strings as anchors
-<TR><TD>ESC :<TD>Mark Message-ID-like strings as news anchors
-<TR><TD>c<TD>Peek current URL
-<TR><TD>=<TD>Display information about current document
-<TR><TD>C-g<TD>Show current line number
-<TR><TD>C-h<TD>View history of URL
-<TR><TD>F<TD>Render frame
-<TR><TD>M<TD>Browse current document using external browser
-(use 2M, 3M, ..., and 9M to invoke second, third, ..., and ninth browser)
-<TR><TD>ESC M<TD>Browse link using external browser
-(use 2ESC M, 3ESC M, ..., and 9ESC M to invoke second, third, ..., and ninth browser)
-</table>
-
-<H3>File/Stream operation</H3>
-<table>
-<TR><TD WIDTH=100>U<TD>Open URL
-<TR><TD>V<TD>View new file
-<TR><TD>@<TD>Execute shell command and load
-<TR><TD>#<TD>Execute shell command and browse
-</table>
-
-<H3>Buffer operation</H3>
-<table>
-<TR><TD WIDTH=100>B<TD>Back to the previous buffer
-<TR><TD>v<TD>View HTML source
-<TR><TD>s<TD>Select buffer
-<TR><TD>E<TD>Edit buffer source
-<TR><TD>C-l<TD>Redraw screen
-<TR><TD>R<TD>Reload buffer
-<TR><TD>S<TD>Save buffer
-<TR><TD>ESC s<TD>Save source
-<TR><TD>ESC e<TD>Edit buffer image
-</table>
-
-<H3>Buffer selection mode</H3>
-<table>
-<TR><TD WIDTH=100>k, C-p<TD>Select previous buffer
-<TR><TD>j, C-n<TD>Select next buffer
-<TR><TD>D<TD>Delect current buffer
-<TR><TD>RET<TD>Go to the selected buffer
-</table>
-
-<H3>Bookmark operation</H3>
-<table>
-<TR><TD WIDTH=100>ESC b<TD>Load bookmark
-<TR><TD>ESC a<TD>Add current to bookmark
-</table>
-
-<H3>Search</H3>
-<table>
-<TR><TD WIDTH=100>/,C-s<TD>Search forward
-<TR><TD>?,C-r<TD>Search backward
-<TR><TD>n<TD>Search next
-<TR><TD>N<TD>Search previous
-<TR><TD>C-w<TD>Toggle wrap search mode
-</table>
-
-<H3>Mark operation</H3>
-<table>
-<TR><TD WIDTH=100>C-SPC<TD>Set/unset mark
-<TR><TD>ESC p<TD>Go to previous mark
-<TR><TD>ESC n<TD>Go to next mark
-<TR><TD>"<TD>Mark by regular expression
-</table>
-
-<H3>Miscellany</H3>
-<table>
-<TR><TD WIDTH=100>!<TD>Execute shell command
-<TR><TD>H<TD>Help (load this file)
-<TR><TD>o<TD>Set option
-<TR><TD>C-k<TD>Show cookie jar
-<TR><TD>C-c<TD>Stop
-<TR><TD>C-z<TD>Suspend
-<TR><TD>q<TD>Quit (with confirmation, if you like)
-<TR><TD>Q<TD>Quit without confirmation
-</table>
-
-<H3>Line-edit mode</H3>
-<table>
-<TR><TD WIDTH=100>C-f<TD>Move cursor forward
-<TR><TD>C-b<TD>Move cursor backward
-<TR><TD>C-h<TD>Delete previous character
-<TR><TD>C-d<TD>Delete current character
-<TR><TD>C-k<TD>Kill everything after cursor
-<TR><TD>C-u<TD>Kill everything before cursor
-<TR><TD>C-a<TD>Move to the top of line
-<TR><TD>C-e<TD>Move to the bottom of line
-<TR><TD>C-p<TD>Fetch the previous string from the history list
-<TR><TD>C-n<TD>Fetch the next string from the history list
-<TR><TD>TAB,SPC<TD>Complete filename
-<TR><TD>RETURN<TD>Accept
-</table>
-
-<hr>
-<a name="Key:lynx"></a>
-<h2>Lynx-like key binding</h2>
-
-If you have chosen `Lynx-like key binding' at the compile time,
-you can use the following key binding.
-
-<H3>Page/Cursor motion</H3>
-<table>
-<TR><TD WIDTH=100>SPC,C-v,+<TD>Forward page
-<TR><TD>b,ESC v,-<TD>Previous page
-<TR><TD>l<TD>Cursor right
-<TR><TD>h<TD>Cursor left
-<TR><TD>j<TD>Cursor down
-<TR><TD>k<TD>Cursor up
-<TR><TD>J<TD>Roll up one line
-<TR><TD>K<TD>Roll down one line
-<TR><TD>^<TD>Go to the beginning of line
-<TR><TD>$<TD>Go to the end of line
-<TR><TD>&gt;<TD>Shift screen right
-<TR><TD>&lt;<TD>Shift screen left
-<TR><TD>C-a<TD>Go to the first line
-<TR><TD>C-e<TD>Go to the last line
-<TR><TD>G<TD>Go to the specified line
-<TR><TD>Z<TD>Move to the center line
-<TR><TD>z<TD>Move to the center column
-<TR><TD>TAB,C-n,Down arrow<TD>Move to next hyperlink
-<TR><TD>ESC TAB,C-p,Up arrow<TD>Move to previous link
-<TR><TD>C-g<TD>Show current page position
-</table>
-
-
-<H2>Hyperlink operation</H2>
-<table>
-<TR><TD WIDTH=100>RET, C-f, Right arrow<TD>Follow hyperlink
-<TR><TD>d, ESC RET<TD>Save link to file
-<TR><TD>u<TD>Peek link URL
-<TR><TD>i<TD>Peek image URL
-<TR><TD>I<TD>View inline image
-<TR><TD>ESC I<TD>Save inline image to file
-<TR><TD>:<TD>Mark URL-like strings as anchors
-<TR><TD>ESC :<TD>Mark Message-ID-like strings as news anchors
-<TR><TD>c<TD>Peek current URL
-<TR><TD>=<TD>Display information about current document
-<TR><TD>C-h<TD>View history of URL
-<TR><TD>F<TD>Render frame
-<TR><TD>M<TD>Browse current document using external browser
-(use 2M and 3M to invoke second and third browser)
-<TR><TD>ESC M<TD>Browse link using external browser
-(use 2ESC M and 3ESC M to invoke second and third browser)
-</table>
-
-<H2>File/Stream operation</H2>
-<table>
-<TR><TD WIDTH=100>g,U<TD>Open URL
-<TR><TD>V<TD>View new file
-<TR><TD>@<TD>Execute shell command and load
-<TR><TD>#<TD>Execute shell command and browse
-</table>
-
-<H2>Buffer operation</H2>
-<table>
-<TR><TD WIDTH=100>B, C-b, Left arrow<TD>Back to the previous buffer
-<TR><TD>\<TD>View HTML source
-<TR><TD>s, C-h<TD>Select buffer
-<TR><TD>E<TD>Edit buffer source
-<TR><TD>C-l, C-w<TD>Redraw screen
-<TR><TD>R, C-r<TD>Reload buffer
-<TR><TD>S, p<TD>Save buffer
-<TR><TD>ESC s<TD>Save source
-<TR><TD>ESC e<TD>Edit buffer image
-</table>
-
-<H2>Buffer selection mode</H2>
-<table>
-<TR><TD WIDTH=100>k, C-p<TD>Select previous buffer
-<TR><TD>j, C-n<TD>Select next buffer
-<TR><TD>D<TD>Delect current buffer
-<TR><TD>RET<TD>Go to the selected buffer
-</table>
-
-<H2>Bookmark operation</H2>
-<table>
-<TR><TD WIDTH=100>v, ESC b<TD>Load bookmark
-<TR><TD>a, ESC a<TD>Add current to bookmark
-</table>
-
-<H2>Search</H2>
-<table>
-<TR><TD WIDTH=100>/, C-s<TD>Search forward
-<TR><TD>n<TD>Search next
-<TR><TD>w<TD>Toggle wrap search mode
-</table>
-
-<H2>Mark operation</H2>
-<table>
-<TR><TD WIDTH=100>C-SPC<TD>Set/unset mark
-<TR><TD>P<TD>Go to previous mark
-<TR><TD>N<TD>Go to next mark
-<TR><TD>"<TD>Mark by regular expression
-</table>
-
-<H2>Miscellany</H2>
-<table>
-<TR><TD WIDTH=100>!<TD>Execute shell command
-<TR><TD>H, ?<TD>Help (load this file)
-<TR><TD>o<TD>Set option
-<TR><TD>C-k<TD>Show cookie jar
-<TR><TD>C-c<TD>Stop
-<TR><TD>C-z<TD>Suspend
-<TR><TD>q<TD>Quit (with confirmation, if you like)
-<TR><TD>Q<TD>Quit without confirmation
-</table>
-
-<H2>Line-edit mode</H2>
-<table>
-<TR><TD WIDTH=100>C-f<TD>Move cursor forward
-<TR><TD>C-b<TD>Move cursor backward
-<TR><TD>C-h<TD>Delete previous character
-<TR><TD>C-d<TD>Delete current character
-<TR><TD>C-k<TD>Kill everything after cursor
-<TR><TD>C-u<TD>Kill everything before cursor
-<TR><TD>C-a<TD>Move to the top of line
-<TR><TD>C-e<TD>Move to the bottom of line
-<TR><TD>C-p<TD>Fetch the previous string from the history list
-<TR><TD>C-n<TD>Fetch the next string from the history list
-<TR><TD>TAB,SPC<TD>Complete filename
-<TR><TD>RETURN<TD>Accept
-</table>
-
-<hr>
-<a name="Mouse"></a>
-<h2>Mouse operation</h2>
-If w3m is compiled with mouse option and you are using
-xterm/kterm/rxvt (in this case, you have to set the TERM
-environment variable to `xterm' or `kterm'.) or GPM
-environment, you can use mouse
-for the navigation.
-<p>
-<table border=0>
-<tr><td>left click
-<td>Move the cursor to the place pointed by the mouse cursor.
-If you click the cursor and it is on an anchor, follow the anchor.
-<tr><td>middle click
-<td>Back to the previous buffer.
-<tr><td>right click
-<td>Open pop-up menu. You can choose an item by clicking it.
-<tr><td>left drag
-<td>Scroll document. The default behavior is to grab the document
-and drag it. You can reverse the behavior (grab the window and drag it)
-with the option setting panel.
-</table>
-<p>
-
-
-<hr>
-<a name="Key:custom"></a>
-<h2>Key customization</h2>
-You can customize the key binding (except line-editing keymap)
-by describing ~/.w3m/keymap. For example,
+ </dd>
+ <dt>
+ -m
+ </dt>
+ <dd>
+ <p>
+ Display document using <q>Internet message mode</q>. With this
+ option, w3m determines document type from header information.
+ This is useful when reading e-mail or Usenet news posts.
+ </p>
+ </dd>
+ <dt>
+ -v
+ </dt>
+ <dd>
+ <p>
+ Show w3m's startup page.
+ </p>
+ </dd>
+ <dt>
+ -B
+ </dt>
+ <dd>
+ <p>
+ Show w3m's bookmarks page.
+ </p>
+ </dd>
+ <dt>
+ -bookmark <i>file</i>
+ </dt>
+ <dd>
+ <p>
+ Specify a custom bookmarks file.
+ </p>
+ </dd>
+ <dt>
+ -M
+ </dt>
+ <dd>
+ <p>
+ Monochrome display mode.
+ </p>
+ </dd>
+ <dt>
+ -F
+ </dt>
+ <dd>
+ <p>
+ Automatically render HTML frames.
+ </p>
+ </dd>
+ <dt>
+ -s
+ </dt>
+ <dd>
+ <p>
+ Squeeze blank lines.
+ </p>
+ </dd>
+ <dt>
+ -X
+ </dt>
+ <dd>
+ <p>
+ Upon exit, do not reinitialize the terminal.
+ <p>
+ </dd>
+ <dt>
+ -W
+ </dt>
+ <dd>
+ <p>
+ Toggle wrapping mode in searches.
+ </p>
+ </dd>
+ <dt>
+ -o <i>option</i>=<i>value</i>
+ </dt>
+ <dd>
+ <p>
+ Specify option. The available option names and values are the
+ same as in ~/.w3m/config.
+ </p>
+ </dd>
+ <dt>
+ -cookie
+ </dt>
+ <dd>
+ <p>
+ Process cookies.
+ </p>
+ </dd>
+ <dt>
+ -no-cookie
+ </dt>
+ <dd>
+ <p>
+ Don't process cookies.
+ </p>
+ </dd>
+ <dt>
+ -num
+ </dt>
+ <dd>
+ <p>
+ Show line-numbers.
+ </p>
+ </dd>
+ <dt>
+ -dump
+ </dt>
+ <dd>
+ <p>
+ Read document specified by URL and dump page rendered as text
+ into standard output. An 80 column width is used unless set with
+ the -cols option.
+ </p>
+ </dd>
+ <dt>
+ -cols <i>width</i>
+ </dt>
+ <dd>
+ <p>
+ Specify document width. Used with -dump option.
+ </p>
+ </dd>
+ <dt>
+ -ppc <i>count</i>
+ </dt>
+ <dd>
+ <p>
+ Specify the number of pixels per character (default 8.0). Larger
+ values will make tables narrower.
+ </p>
+ </dd>
+ <dt>
+ -dump_source
+ </dt>
+ <dd>
+ <p>
+ Read document specified by URL and dump the source.
+ </p>
+ </dd>
+ <dt>
+ -dump_head
+ </dt>
+ <dd>
+ <p>
+ Read document specified by URL and dump headers.
+ </p>
+ </dd>
+ <dt>
+ -dump_both
+ </dt>
+ <dd>
+ <p>
+ Read document specified by URL and dump headers and the source.
+ </p>
+ </dd>
+ <dt>
+ -dump_extra
+ </dt>
+ <dd>
+ <p>
+ Read document specified by URL and dump extra informations,
+ headers, and the source.
+ </p>
+ </dd>
+ <dt>
+ -post <i>file</i>
+ </dt>
+ <dd>
+ <p>
+ Use POST method with file content.
+ </p>
+ </dd>
+ <dt>
+ -header <i>string</i>
+ </dt>
+ <dd>
+ <p>
+ Insert string as a header.
+ </p>
+ </dd>
+ <dt>
+ -no-proxy
+ </dt>
+ <dd>
+ <p>
+ Don't use proxy server.
+ </p>
+ </dd>
+ <dt>
+ -no-graph
+ </dt>
+ <dd>
+ <p>
+ Use ASCII characters to draw frames rather than graphical ones.
+ </p>
+ </dd>
+ <dt>
+ -no-mouse
+ </dt>
+ <dd>
+ <p>
+ Deactivate mouse support.
+ </p>
+ </dd>
+ <dt>
+ -config <i>file</i>
+ </dt>
+ <dd>
+ <p>
+ Specify config file.
+ </p>
+ </dd>
+ </dl>
+ <hr>
+ <h2 id="Color">
+ Document colors
+ </h2>
+ <p>
+ Links and images are displayed as follows.
+ </p>
+ <div align="center">
+ <table border="1">
+ <tr>
+ <th>
+ &nbsp;
+ </th>
+ <th>
+ Color mode
+ </th>
+ <th>
+ Monochrome mode
+ </th>
+ </tr>
+ <tr>
+ <td>
+ links
+ </td>
+ <td>
+ blue
+ </td>
+ <td>
+ underline
+ </td>
+ </tr>
+ <tr>
+ <td>
+ inline images
+ </td>
+ <td>
+ green
+ </td>
+ <td>
+ reverse
+ </td>
+ </tr>
+ <tr>
+ <td>
+ form input
+ </td>
+ <td>
+ red
+ </td>
+ <td>
+ reverse
+ </td>
+ </tr>
+ </table>
+ </div>
+ <p>
+ These colors can be customized using the option setting command
+ <q>o</q>.
+ </p>
+ <hr>
+ <h2 id="Key:orig">
+ Key bindings
+ </h2>
+<!--
+ TODO: reorganise this whole thing into one big table of
+ FUNCTIONNAME | description | default-binding | Lynxlike-binding
+!-->
+ <p>
+ After invoking w3m, you can control it with keyboard commands.
+ </p>
+ <p>
+ Here's the original key-binding table. If you are using Lynx-like
+ key bindings, see <a href="#Key:lynx">the Lynx-like key
+ bindings</a>. Throughout, the <q>C-</q> and <q>M-</q> notations
+ indicate the modifiers <q>control</q> and <q>meta</q> (which can be
+ replaced with <q>alt</q> or ESC); on the other hand <q>2&nbsp;M</q>
+ simply means <q>2</q> followed by <q>M</q>.
+ </p>
+ <h3>
+ In-page navigation
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ SPC, C-v, +, PGDN
+ </td>
+ <td>
+ Forward page
+ </td>
+ </tr>
+ <tr>
+ <td>
+ b, M-v, -, PGUP
+ </td>
+ <td>
+ Backward page
+ </td>
+ </tr>
+ <tr>
+ <td>
+ l, C-f, RIGHT
+ </td>
+ <td>
+ Cursor right
+ </td>
+ </tr>
+ <tr>
+ <td>
+ h, C-b, LEFT
+ </td>
+ <td>
+ Cursor left
+ </td>
+ </tr>
+ <tr>
+ <td>
+ j, C-n, DOWN
+ </td>
+ <td>
+ Cursor down
+ </td>
+ </tr>
+ <tr>
+ <td>
+ k, C-p, UP
+ </td>
+ <td>
+ Cursor up
+ </td>
+ </tr>
+ <tr>
+ <td>
+ J
+ </td>
+ <td>
+ Scroll screen up one line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ K
+ </td>
+ <td>
+ Scroll screen down one line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ ^, C-a
+ </td>
+ <td>
+ Go to the beginning of line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ $, C-e
+ </td>
+ <td>
+ Go to the end of line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ w
+ </td>
+ <td>
+ Go to next word
+ </td>
+ </tr>
+ <tr>
+ <td>
+ W
+ </td>
+ <td>
+ Go to previous word
+ </td>
+ </tr>
+ <tr>
+ <td>
+ &gt;
+ </td>
+ <td>
+ Shift screen right
+ </td>
+ </tr>
+ <tr>
+ <td>
+ &lt;
+ </td>
+ <td>
+ Shift screen left
+ </td>
+ </tr>
+ <tr>
+ <td>
+ .
+ </td>
+ <td>
+ Shift screen one column right
+ </td>
+ </tr>
+ <tr>
+ <td>
+ ,
+ </td>
+ <td>
+ Shift screen one column left
+ </td>
+ </tr>
+ <tr>
+ <td>
+ g, M-&lt;, HOME
+ </td>
+ <td>
+ Go to the first line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ G, M-&gt;, END
+ </td>
+ <td>
+ Go to the last line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-g
+ </td>
+ <td>
+ Go to specified line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ Z
+ </td>
+ <td>
+ Center on cursor column
+ </td>
+ </tr>
+ <tr>
+ <td>
+ z
+ </td>
+ <td>
+ Center on cursor line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ TAB
+ </td>
+ <td>
+ Move to next hyperlink
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-u, M-TAB
+ </td>
+ <td>
+ Move to previous hyperlink
+ </td>
+ </tr>
+ <tr>
+ <td>
+ [
+ </td>
+ <td>
+ Move to the first hyperlink
+ </td>
+ </tr>
+ <tr>
+ <td>
+ ]
+ </td>
+ <td>
+ Move to the last hyperlink
+ </td>
+ </tr>
+ </table>
+ <h3>Hyperlink operation</h3>
+ <table>
+ <tr>
+ <td width="100">
+ C-j, C-m, RET
+ </td>
+ <td>
+ Follow hyperlink
+ </td>
+ </tr>
+ <tr>
+ <td>
+ a, M-RET
+ </td>
+ <td>
+ Save link to file
+ </td>
+ </tr>
+ <tr>
+ <td>
+ u
+ </td>
+ <td>
+ Show link URL
+ </td>
+ </tr>
+ <tr>
+ <td>
+ i
+ </td>
+ <td>
+ Show image URL
+ </td>
+ </tr>
+ <tr>
+ <td>
+ I
+ </td>
+ <td>
+ View inline image
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-I
+ </td>
+ <td>
+ Save inline image to file
+ </td>
+ </tr>
+ <tr>
+ <td>
+ :
+ </td>
+ <td>
+ Mark URL-like strings as hyperlinks
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-:
+ </td>
+ <td>
+ Mark Message-ID-like strings as links
+ </td>
+ </tr>
+ <tr>
+ <td>
+ c
+ </td>
+ <td>
+ Show current URL
+ </td>
+ </tr>
+ <tr>
+ <td>
+ =
+ </td>
+ <td>
+ Show information about current document
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-g
+ </td>
+ <td>
+ Show current position in page
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-h
+ </td>
+ <td>
+ Show browsing history
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M
+ </td>
+ <td>
+ Browse current document using external browser (prefix 2, 3, ...,
+ or 9 to invoke alternate configured browsers, e.g. 3&nbsp;M)
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-M
+ </td>
+ <td>
+ Browse link using external browser (prefixed as above, e.g.
+ 3&nbsp;M-M)
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Bookmark management
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ M-b
+ </td>
+ <td>
+ Go to bookmarks page
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-a
+ </td>
+ <td>
+ Bookmark current page
+ </td>
+ </tr>
+ </table>
+ <h3>
+ File/stream operation
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ U
+ </td>
+ <td>
+ Open new URL
+ </td>
+ </tr>
+ <tr>
+ <td>
+ V
+ </td>
+ <td>
+ Open new file
+ </td>
+ </tr>
+ <tr>
+ <td>
+ @
+ </td>
+ <td>
+ Execute shell command and view output
+ </td>
+ </tr>
+ <tr>
+ <td>
+ #
+ </td>
+ <td>
+ Execute shell command and browse output
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Content operations
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ v
+ </td>
+ <td>
+ Toggle viewing as text or rendered HTML
+ </td>
+ </tr>
+ <tr>
+ <td>
+ F
+ </td>
+ <td>
+ Toggle rendering HTML frames
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-l
+ </td>
+ <td>
+ Redraw screen
+ </td>
+ </tr>
+ <tr>
+ <td>
+ R
+ </td>
+ <td>
+ Reload
+ </td>
+ </tr>
+ <tr>
+ <td>
+ E
+ </td>
+ <td>
+ Edit local source
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-e
+ </td>
+ <td>
+ Edit rendered copy of page
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-s
+ </td>
+ <td>
+ Save source
+ </td>
+ </tr>
+ <tr>
+ <td>
+ S
+ </td>
+ <td>
+ Save rendered copy of page
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Buffer/tab navigation
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ B
+ </td>
+ <td>
+ Go back, <q>popping</q> the buffer stack
+ </td>
+ </tr>
+ <tr>
+ <td>
+ s
+ </td>
+ <td>
+ Show buffer-stack menu
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-t
+ </td>
+ <td>
+ Show tab menu
+ </td>
+ </tr>
+ <tr>
+ <td>
+ T
+ </td>
+ <td>
+ Open current page as new tab
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-t
+ </td>
+ <td>
+ Open link as new tab
+ </td>
+ </tr>
+ <tr>
+ <td>
+ }
+ </td>
+ <td>
+ Switch to next tab
+ </td>
+ </tr>
+ <tr>
+ <td>
+ {
+ </td>
+ <td>
+ Switch to previous tab
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-q
+ </td>
+ <td>
+ Close current tab
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Search
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ /
+ </td>
+ <td>
+ Search forward
+ </td>
+ </tr>
+ <tr>
+ <td>
+ ?
+ </td>
+ <td>
+ Search backward
+ </td>
+ </tr>
+ <tr>
+ <td width="100">
+ C-s
+ </td>
+ <td>
+ Incremental search forward
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-r
+ </td>
+ <td>
+ Incremental search backward
+ </td>
+ </tr>
+ <tr>
+ <td>
+ n
+ </td>
+ <td>
+ Next match
+ </td>
+ </tr>
+ <tr>
+ <td>
+ N
+ </td>
+ <td>
+ Previous match
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-w
+ </td>
+ <td>
+ Toggle wrapping mode in searches
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Mark management
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ C-SPC
+ </td>
+ <td>
+ Set/unset mark
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-p
+ </td>
+ <td>
+ Go to previous mark
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-n
+ </td>
+ <td>
+ Go to next mark
+ </td>
+ </tr>
+ <tr>
+ <td>
+ "
+ </td>
+ <td>
+ Mark all occurrences of a regular expression
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Miscellany
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ !
+ </td>
+ <td>
+ Execute shell command
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-c
+ </td>
+ <td>
+ Invoke w3m function
+ </td>
+ </tr>
+ <tr>
+ <td>
+ H
+ </td>
+ <td>
+ Show help panel
+ </td>
+ </tr>
+ <tr>
+ <td>
+ o
+ </td>
+ <td>
+ Show options panel
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-k
+ </td>
+ <td>
+ Show cookie jar
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-c
+ </td>
+ <td>
+ Interrupt
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-z
+ </td>
+ <td>
+ Suspend w3m
+ </td>
+ </tr>
+ <tr>
+ <td>
+ q
+ </td>
+ <td>
+ Quit (with confirmation dialog)
+ </td>
+ </tr>
+ <tr>
+ <td>
+ Q
+ </td>
+ <td>
+ Quit without confirmation
+ </td>
+ </tr>
+ </table>
+<!--
+ TODO: import leftovers from current keymap (same in both):
+ ( UNDO
+ ) REDO
+ ; MARK_WORD
+ D DOWNLOAD_LIST
+ L LIST
+ m MOUSE_TOGGLE
+ r VERSION
+ | PIPE_BUF
+ M-W DICT_WORD_AT
+ M-c COMMAND
+ M-k DEFINE_KEY
+ M-l LIST_MENU
+ M-m MOVE_LIST_MENU
+ M-o SET_OPTION
+ M-u GOTO_RELATIVE
+ M-w DICT_WORD
+ M-Fn MENU
+!-->
+ <p>
+ Two special operational modes exist which have built-in (not
+ redefinable) keymappings:
+ </p>
+ <h3>
+ Menu selection mode
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ k, C-p, UP
+ </td>
+ <td>
+ Select previous item
+ </td>
+ </tr>
+ <tr>
+ <td>
+ j, C-n, DOWN
+ </td>
+ <td>
+ Select next item
+ </td>
+ </tr>
+ <tr>
+ <td>
+ D
+ </td>
+ <td>
+ Delete current item
+ </td>
+ </tr>
+ <tr>
+ <td>
+ SPC, RET
+ </td>
+ <td>
+ Go to the selected item
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Line-editing mode
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ C-f, RIGHT
+ </td>
+ <td>
+ Move cursor forward
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-b, LEFT
+ </td>
+ <td>
+ Move cursor backward
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-h, BKSPC
+ </td>
+ <td>
+ Delete previous character
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-d
+ </td>
+ <td>
+ Delete current character
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-k
+ </td>
+ <td>
+ Kill everything after cursor
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-u
+ </td>
+ <td>
+ Kill everything before cursor
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-a
+ </td>
+ <td>
+ Move to the beginning of line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-e
+ </td>
+ <td>
+ Move to the end of line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-p, UP
+ </td>
+ <td>
+ Fetch the previous string from the history list
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-n, DOWN
+ </td>
+ <td>
+ Fetch the next string from the history list
+ </td>
+ </tr>
+ <tr>
+ <td>
+ TAB, SPC
+ </td>
+ <td>
+ Try to complete filename
+ </td>
+ </tr>
+ <tr>
+ <td>
+ RET
+ </td>
+ <td>
+ Accept
+ </td>
+ </tr>
+ </table>
+ <hr>
+ <h2 id="Key:lynx">
+ Lynx-like key bindings
+ </h2>
+ <p>
+ If w3m was compiled with <q>Lynx-like key bindings</q>, you can use
+ the following key bindings.
+ </p>
+ <h3>
+ In-page navigation
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ SPC, C-v, +
+ </td>
+ <td>
+ Forward page
+ </td>
+ </tr>
+ <tr>
+ <td>
+ b, M-v, -
+ </td>
+ <td>
+ Backward page
+ </td>
+ </tr>
+ <tr>
+ <td>
+ l
+ </td>
+ <td>
+ Cursor right
+ </td>
+ </tr>
+ <tr>
+ <td>
+ h
+ </td>
+ <td>
+ Cursor left
+ </td>
+ </tr>
+ <tr>
+ <td>
+ j
+ </td>
+ <td>
+ Cursor down
+ </td>
+ </tr>
+ <tr>
+ <td>
+ k
+ </td>
+ <td>
+ Cursor up
+ </td>
+ </tr>
+ <tr>
+ <td>
+ J
+ </td>
+ <td>
+ Scroll screen up one line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ K
+ </td>
+ <td>
+ Scroll screen down one line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ ^
+ </td>
+ <td>
+ Go to the beginning of line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ $
+ </td>
+ <td>
+ Go to the end of line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ &gt;
+ </td>
+ <td>
+ Shift screen right
+ </td>
+ </tr>
+ <tr>
+ <td>
+ &lt;
+ </td>
+ <td>
+ Shift screen left
+ </td>
+ </tr>
+ <tr>
+ <td>
+ .
+ </td>
+ <td>
+ Shift screen one column right
+ </td>
+ </tr>
+ <tr>
+ <td>
+ ,
+ </td>
+ <td>
+ Shift screen one column left
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-a, M-&lt;
+ </td>
+ <td>
+ Go to the first line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-e, M-&gt;
+ </td>
+ <td>
+ Go to the last line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ G
+ </td>
+ <td>
+ Go to the specified line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ w
+ </td>
+ <td>
+ Go to next word
+ </td>
+ </tr>
+ <tr>
+ <td>
+ W
+ </td>
+ <td>
+ Go to previous word
+ </td>
+ </tr>
+ <tr>
+ <td>
+ Z
+ </td>
+ <td>
+ Center on cursor line
+ </td>
+ </tr>
+ <tr>
+ <td>
+ z
+ </td>
+ <td>
+ Center on cursor column
+ </td>
+ </tr>
+ <tr>
+ <td>
+ TAB, C-n, DOWN
+ </td>
+ <td>
+ Move to next hyperlink
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-TAB, C-p, C-u, UP
+ </td>
+ <td>
+ Move to previous link
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-g
+ </td>
+ <td>
+ Show current position in page
+ </td>
+ </tr>
+ <tr>
+ <td>
+ [
+ </td>
+ <td>
+ Move to the first hyperlink
+ </td>
+ </tr>
+ <tr>
+ <td>
+ ]
+ </td>
+ <td>
+ Move to the last hyperlink
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Hyperlink operation
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ C-f, C-j, C-m, RET, RIGHT
+ </td>
+ <td>
+ Follow hyperlink
+ </td>
+ </tr>
+ <tr>
+ <td>
+ d, M-RET
+ </td>
+ <td>
+ Save link to file
+ </td>
+ </tr>
+ <tr>
+ <td>
+ u
+ </td>
+ <td>
+ Show link URL
+ </td>
+ </tr>
+ <tr>
+ <td>
+ i
+ </td>
+ <td>
+ Show image URL
+ </td>
+ </tr>
+ <tr>
+ <td>
+ I
+ </td>
+ <td>
+ View inline image
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-I
+ </td>
+ <td>
+ Save inline image to file
+ </td>
+ </tr>
+ <tr>
+ <td>
+ :
+ </td>
+ <td>
+ Mark URL-like strings as hyperlinks
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-:
+ </td>
+ <td>
+ Mark Message-ID-like strings as links
+ </td>
+ </tr>
+ <tr>
+ <td>
+ c
+ </td>
+ <td>
+ Show current URL
+ </td>
+ </tr>
+ <tr>
+ <td>
+ =
+ </td>
+ <td>
+ Show information about current document
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-h
+ </td>
+ <td>
+ Show browsing history
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M
+ </td>
+ <td>
+ Browse current document using external browser (prefix 2, 3, ...,
+ or 9 to invoke alternate configured browsers, e.g. 3&nbsp;M)
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-M
+ </td>
+ <td>
+ Browse link using external browser (prefixed as above, e.g.
+ 3&nbsp;M-M)
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Bookmark management
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ v, M-b
+ </td>
+ <td>
+ Go to bookmarks page
+ </td>
+ </tr>
+ <tr>
+ <td>
+ a, M-a
+ </td>
+ <td>
+ Bookmark current page
+ </td>
+ </tr>
+ </table>
+ <h3>
+ File/stream operation
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ g, U
+ </td>
+ <td>
+ Open new URL
+ </td>
+ </tr>
+ <tr>
+ <td>
+ V
+ </td>
+ <td>
+ Open new file
+ </td>
+ </tr>
+ <tr>
+ <td>
+ @
+ </td>
+ <td>
+ Execute shell command and view output
+ </td>
+ </tr>
+ <tr>
+ <td>
+ #
+ </td>
+ <td>
+ Execute shell command and browse output
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Content operations
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ \
+ </td>
+ <td>
+ Toggle viewing as text or rendered HTML
+ </td>
+ </tr>
+ <tr>
+ <td>
+ F
+ </td>
+ <td>
+ Toggle rendering HTML frames
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-l, C-w
+ </td>
+ <td>
+ Redraw screen
+ </td>
+ </tr>
+ <tr>
+ <td>
+ R, C-r
+ </td>
+ <td>
+ Reload
+ </td>
+ </tr>
+ <tr>
+ <td>
+ E
+ </td>
+ <td>
+ Edit local source
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-e
+ </td>
+ <td>
+ Edit rendered copy of page
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-s
+ </td>
+ <td>
+ Save source
+ </td>
+ </tr>
+ <tr>
+ <td>
+ S, p
+ </td>
+ <td>
+ Save rendered copy of page
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Buffer/tab navigation
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ B, C-b, LEFT
+ </td>
+ <td>
+ Go back, <q>popping</q> the buffer stack
+ </td>
+ </tr>
+ <tr>
+ <td>
+ s, C-h
+ </td>
+ <td>
+ Show buffer-stack menu
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-t
+ </td>
+ <td>
+ Show tab menu
+ </td>
+ </tr>
+ <tr>
+ <td>
+ T
+ </td>
+ <td>
+ Open current page as new tab
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-t
+ </td>
+ <td>
+ Open link as new tab
+ </td>
+ </tr>
+ <tr>
+ <td>
+ }
+ </td>
+ <td>
+ Switch to next tab
+ </td>
+ </tr>
+ <tr>
+ <td>
+ {
+ </td>
+ <td>
+ Switch to previous tab
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-q
+ </td>
+ <td>
+ Close current tab
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Search
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ /, C-s
+ </td>
+ <td>
+ Search forward
+ </td>
+ </tr>
+ <tr>
+ <td>
+ n
+ </td>
+ <td>
+ Next match
+ </td>
+ </tr>
+ <tr>
+ <td>
+ w
+ </td>
+ <td>
+ Toggle wrapping mode in searches
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Mark management
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ C-SPC
+ </td>
+ <td>
+ Set/unset mark
+ </td>
+ </tr>
+ <tr>
+ <td>
+ P
+ </td>
+ <td>
+ Go to previous mark
+ </td>
+ </tr>
+ <tr>
+ <td>
+ N
+ </td>
+ <td>
+ Go to next mark
+ </td>
+ </tr>
+ <tr>
+ <td>
+ "
+ </td>
+ <td>
+ Mark all occurrences of a regular expression
+ </td>
+ </tr>
+ </table>
+ <h3>
+ Miscellany
+ </h3>
+ <table>
+ <tr>
+ <td width="100">
+ !
+ </td>
+ <td>
+ Execute shell command
+ </td>
+ </tr>
+ <tr>
+ <td>
+ M-c
+ </td>
+ <td>
+ Invoke w3m function
+ </td>
+ </tr>
+ <tr>
+ <td>
+ H, ?
+ </td>
+ <td>
+ Show help panel
+ </td>
+ </tr>
+ <tr>
+ <td>
+ o
+ </td>
+ <td>
+ Show options panel
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-k
+ </td>
+ <td>
+ Show cookie jar
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-c
+ </td>
+ <td>
+ Interrupt
+ </td>
+ </tr>
+ <tr>
+ <td>
+ C-z
+ </td>
+ <td>
+ Suspend w3m
+ </td>
+ </tr>
+ <tr>
+ <td>
+ q
+ </td>
+ <td>
+ Quit (with confirmation dialog)
+ </td>
+ </tr>
+ <tr>
+ <td>
+ Q
+ </td>
+ <td>
+ Quit without confirmation
+ </td>
+ </tr>
+ </table>
+ <p>
+ The Lynx-like configuration leaves keymappings unchanged in the
+ menu-selection and line-editing modes.
+ </p>
+ <hr>
+ <h2 id="Mouse">
+ Mouse operation
+ </h2>
+ <p>
+ If w3m is compiled with mouse support and you are invoking w3m
+ either from a console with GPM or from an X terminal emulator, you
+ can use the mouse for navigation (in the case of rxvt, you need to
+ set the TERM environment variable to <q>xterm</q> or <q>kterm</q>).
+ <p>
+ <table border="0">
+ <tr>
+ <td>
+ left click
+ </td>
+ <td>
+ Move the cursor to the place indicated by the mouse cursor.
+ If you click the cursor and it is on a hyperlink, follow the
+ link.
+ </td>
+ </tr>
+ <tr>
+ <td>
+ middle click
+ </td>
+ <td>
+ Back to the previous buffer.
+ </td>
+ </tr>
+ <tr>
+ <td>
+ right click
+ </td>
+ <td>
+ Open pop-up menu. You can choose an item by clicking it.
+ </td>
+ </tr>
+ <tr>
+ <td>
+ left drag
+ </td>
+ <td>
+ Scroll document. The default behavior is to grab the document
+ and drag it. You can reverse the behavior (grab the window and
+ drag it) with the option setting panel.
+ </td>
+ </tr>
+ </table>
+ <hr>
+ <h2 id="Key:custom">
+ Key customization
+ </h2>
+ <p>
+ You can customize the key bindings (except the line-editing keymap)
+ in a ~/.w3m/keymap file. For example,
+ </p>
<pre>
keymap C-o NEXT_PAGE
</pre>
-binds `NEXT_PAGE' function (normally bound to SPC and C-v)
-to control-o. See <a href="README.func">README.func</a> for
-list of available functions. Original and Lynx-like keymap
-definitions are provided (<a href="keymap.default">keymap.default</a>
-and <a href="keymap.lynx">keymap.lynx</a>) as examples.
-
-<hr>
-<a name="LocalCGI"></a>
-<h2>Local CGI</h2>
-You can run CGI scripts using w3m, without any HTTP server.
-It means that w3m behaves like an HTTP server and activates CGI script,
-then w3m reads the output of the script and display it. The
-bookmark registration and helper-app editor
-are realized as local CGI scripts.
-Using local CGI, w3m can be used as a general purpose form interface.
-<P>
-For security reason, CGI scripts invoked by w3m must be in one of
-these directories.
-<ul>
-<li>The directory where w3m-related files are stored
-(typically /usr/local/lib/w3m). This directory can be referred
-as $LIB.
-<li>/cgi-bin/ directory. You can map /cgi-bin/ to any directory you like
-with option setting panel (``Directory corresponds to /cgi-bin'' field).
-You can specify multiple paths separated by `:', like
-/usr/local/cgi-bin:/home/aito/cgi-bin. To use /cgi-bin/ directory,
-you must use file:/cgi-bin URL as follows:
+ <p>
+ binds the <q>NEXT_PAGE</q> function (normally bound to SPC and C-v)
+ to control-o. See <a href="README.func">README.func</a> for a
+ list of available functions. Original and Lynx-like keymap
+ definitions are provided (<a href="keymap.default">keymap.default</a>
+ and <a href="keymap.lynx">keymap.lynx</a>) as examples.
+ </p>
+ <hr>
+ <h2 id="LocalCGI">
+ Local CGI
+ </h2>
+ <p>
+ You can run CGI scripts using w3m, without any HTTP server.
+ This means that w3m behaves like an HTTP server and runs the CGI
+ script, then reads the output of the script and displays it. For
+ example, the bookmark registration system and default directory
+ browser are realized as local CGI scripts. Moreover, such scripts
+ allow w3m to be used as a form interface to acquire all kinds of
+ data.
+ </p>
+ <p>
+ For security reason, CGI scripts invoked by w3m must be in one of
+ the following directories:
+ </p>
+ <ul>
+ <li>
+ The directory where w3m-related files are stored (typically
+ /usr/local/lib/w3m). This directory can be referenced as $LIB.
+ </li>
+ <li>
+ The /cgi-bin/ directory. You can map /cgi-bin/ to any directory you
+ like in the option setting panel (the <q>Directory corresponds to
+ /cgi-bin</q> field). You can specify multiple paths separated by
+ <q>:</q>, like /usr/local/cgi-bin:/home/aito/cgi-bin. To use a
+ /cgi-bin/ directory, you must use a file:/cgi-bin URL as follows:
<pre>
w3m -o cgi_bin=/path/to/cgi-bin file:/cgi-bin/script.cgi
</pre>
-It is not recommended to include current directory to this path.
-</ul>
-<p>
-The CGI script can use special header `w3m-control:' to control w3m.
-This field can take any function (see <a href="README.func">README.func</a>),
-and the specified function is invoked after the document is displayed.
-For example, The CGI output
+ It is not recommended to include the current directory to this path.
+ </li>
+ </ul>
+ <p>
+ The CGI script can use the special header <q>w3m-control:</q> to
+ control w3m. This field can take any function (see
+ <a href="README.func">README.func</a>), and the specified function
+ is invoked after the document is displayed. For example, the CGI
+ output
+ </p>
<pre>
Content-Type: text/plain
W3m-control: BACK
</pre>
-will display blank page and delete that buffer immediately.
-This is useful when you don't want to display any page after
-the script is invoked. The next example
+ <p>
+ will display a blank page and delete that buffer immediately.
+ This is useful when you don't want to display any page after
+ the script is invoked. The next example
+ </p>
<pre>
Content-Type: text/plain
@@ -507,26 +2111,32 @@ W3m-control: DELETE_PREVBUF
contents.....
</pre>
-will override the current buffer.
-<p>
-One w3m-control: header have to contain only one function, but you can
-include more than one w3m-control: lines in the HTTP header.
-In addition, you can specify an argument to GOTO function:
+ <p>
+ will override the current buffer.
+ </p>
+ <p>
+ Each w3m-control: header can contain only one function, but you can
+ include more than one w3m-control: line in the HTTP header.
+ In addition, you can specify an argument to the GOTO function:
+ </p>
<pre>
Content-Type: text/plain
-W3m-control: GOTO http://www.yahoo.com/
+W3m-control: GOTO http://www.example.org/
</pre>
-This example works exactly the same way to the Location header:
+ <p>
+ This example works exactly the same way as the Location header:
+ </p>
<pre>
Content-Type: text/plain
-Location: http://www.yahoo.com/
+Location: http://www.example.org/
</pre>
-Note that this header has no effect when the CGI script is invoked
-through HTTP server.
-
-</body>
+ <p>
+ Note that this header has no effect when the CGI script is invoked
+ through an HTTP server.
+ </p>
+ </body>
</html>
diff --git a/doc/README.func b/doc/README.func
index 26de39d..5c33459 100644
--- a/doc/README.func
+++ b/doc/README.func
@@ -1,25 +1,25 @@
ABORT Quit w3m without confirmation
-ACCESSKEY Popup accesskey menu
-ADD_BOOKMARK Add current page to bookmark
+ACCESSKEY Pop up accesskey menu
+ADD_BOOKMARK Add current page to bookmarks
ALARM Set alarm
BACK Back to previous buffer
BEGIN Go to the first line
-BOOKMARK Read bookmark
+BOOKMARK View bookmarks
CENTER_H Move to the center line
CENTER_V Move to the center column
-CHARSET Change the current document charset
+CHARSET Change the current document charset
CLOSE_TAB Close current tab
-CLOSE_TAB_MOUSE Close tab on mouse cursor (for mouse action)
-COMMAND Execute w3m command(s)
+CLOSE_TAB_MOUSE Close tab on mouse cursor (for mouse action)
+COMMAND Execute w3m command(s)
COOKIE View cookie list
-DEFAULT_CHARSET Change the default document charset
-DEFINE_KEY Define a binding between a key stroke and a user command
-DELETE_PREVBUF Delete previous buffer (mainly for local-CGI)
+DEFAULT_CHARSET Change the default document charset
+DEFINE_KEY Define a binding between a keystroke and a user command
+DELETE_PREVBUF Delete previous buffer (mainly for local-CGI)
DICT_WORD Execute dictionary command (see README.dict)
-DICT_WORD_AT Execute dictionary command for word at cursor
+DICT_WORD_AT Execute dictionary command for word at cursor
DISPLAY_IMAGE Restart loading and drawing of images
DOWN Scroll down one line
-DOWNLOAD Save document source to file
+DOWNLOAD Save document (source) to file
DOWNLOAD_LIST Display download list panel
EDIT Edit current document
EDIT_SCREEN Edit currently rendered document
@@ -28,75 +28,75 @@ EXEC_SHELL Execute shell command
EXIT Quit w3m without confirmation
EXTERN Execute external browser
EXTERN_LINK View current link using external browser
-FRAME Render frame
+FRAME Render frames
GOTO Go to URL
GOTO_LINE Go to specified line
-GOTO_LINK Go to current link
+GOTO_LINK Follow current link
GOTO_RELATIVE Go to relative URL
HELP View help
-HISTORY View history of URL
+HISTORY View browser history
INFO View info of current document
-INTERRUPT Stop loading document
-INIT_MAILCAP Reread mailcap (mainly for local-CGI)
-ISEARCH Incremental search forward
+INTERRUPT Suspend w3m
+INIT_MAILCAP Reread mailcap (mainly for local-CGI)
+ISEARCH Incremental search forward
ISEARCH_BACK Incremental search backward
LEFT Shift screen one column
LINE_BEGIN Go to the beginning of line
LINE_END Go to the end of line
LINE_INFO Show current line number
-LINK_BEGIN Go to the first link
-LINK_END Go to the last link
-LINK_MENU Popup link element menu
+LINK_BEGIN Go to the first link
+LINK_END Go to the last link
+LINK_MENU Pop up link element menu
LIST Show all links and images
-LIST_MENU Popup link list menu and go to selected link
+LIST_MENU Pop up link list menu and go to selected link
LOAD Load local file
-MAIN_MENU Popup menu
+MAIN_MENU Pop up menu
MARK Set/unset mark
-MARK_MID Mark Message-ID-like strings as anchors
-MARK_URL Mark URL-like strings as anchors
-MARK_WORD Mark current word as anchor
-MENU Popup menu
-MENU_MOUSE Popup menu at mouse cursor (for mouse action)
-MOUSE_TOGGLE Toggle activity of mouse
-MOVE_DOWN Move cursor down (a half screen scroll at the end of screen)
-MOVE_DOWN1 Move cursor down (1 line scroll at the end of screen)
-MOVE_LEFT Move cursor left (a half screen shift at the left edge)
-MOVE_LEFT1 Move cursor left (1 columns shift at the left edge)
-MOVE_LIST_MENU Popup link list menu and move cursor to selected link
+MARK_MID Mark Message-ID-like strings as links
+MARK_URL Mark URL-like strings as links
+MARK_WORD Mark current word as link
+MENU Pop up menu
+MENU_MOUSE Pop up menu at mouse cursor (for mouse action)
+MOUSE_TOGGLE Toggle mouse support
+MOVE_DOWN Move cursor down (a half screen scroll at the end of screen)
+MOVE_DOWN1 Move cursor down (1 line scroll at the end of screen)
+MOVE_LEFT Move cursor left (a half screen shift at the left edge)
+MOVE_LEFT1 Move cursor left (1 column shift at the left edge)
+MOVE_LIST_MENU Pop up link list menu and move cursor to selected link
MOVE_MOUSE Move cursor to mouse cursor (for mouse action)
-MOVE_RIGHT Move cursor right (a half screen shift at the right edge)
-MOVE_RIGHT1 Move cursor right (1 columns shift at the right edge)
-MOVE_UP Move cursor up (a half screen scroll at the top of screen)
-MOVE_UP1 Move cursor up (1 line scrol at the top of screen)
-MSGS Display error messages
-NEW_TAB Open new tab
+MOVE_RIGHT Move cursor right (a half screen shift at the right edge)
+MOVE_RIGHT1 Move cursor right (1 column shift at the right edge)
+MOVE_UP Move cursor up (a half screen scroll at the top of screen)
+MOVE_UP1 Move cursor up (1 line scroll at the top of screen)
+MSGS Display error messages
+NEW_TAB Open new tab
NEXT Move to next buffer
-NEXT_DOWN Move to next downward link
-NEXT_LEFT Move to next left link
-NEXT_LEFT_UP Move to next left (or upward) link
+NEXT_DOWN Move downward to next link
+NEXT_LEFT Move left to next link
+NEXT_LEFT_UP Move left (or upward) to next link
NEXT_LINK Move to next link
NEXT_MARK Move to next word
NEXT_PAGE Move to next page
-NEXT_RIGHT Move to next right link
-NEXT_RIGHT_DOWN Move to next right (or downward) link
+NEXT_RIGHT Move right to next link
+NEXT_RIGHT_DOWN Move right (or downward) to next link
NEXT_TAB Move to next tab
-NEXT_UP Move to next upward link
-NEXT_VISITED Move to next visited link
+NEXT_UP Move upward to next link
+NEXT_VISITED Move to next visited link
NEXT_WORD Move to next word
-NOTHING Do nothing
+NOTHING Do nothing
NULL Do nothing
-OPTIONS Option setting panel
-PEEK Peek current URL
-PEEK_IMG Peek image URL
-PEEK_LINK Peek link URL
-PIPE_BUF Send rendered document to pipe
+OPTIONS Display option setting panel
+PEEK Peek at current URL
+PEEK_IMG Peek at image URL
+PEEK_LINK Peek at link URL
+PIPE_BUF Send rendered document to pipe
PIPE_SHELL Execute shell command and browse
PREV Move to previous buffer
PREV_LINK Move to previous link
PREV_MARK Move to previous mark
PREV_PAGE Move to previous page
PREV_TAB Move to previous tab
-PREV_VISITED Move to previous visited link
+PREV_VISITED Move to previous visited link
PREV_WORD Move to previous word
PRINT Save buffer to file
QUIT Quit w3m
@@ -106,40 +106,40 @@ REDRAW Redraw screen
REG_MARK Set mark using regexp
REINIT Reload configuration files
RELOAD Reload buffer
-RESHAPE Re-render buffer
+RESHAPE Re-render buffer
RIGHT Shift screen one column right
-SAVE Save document source to file
+SAVE Save document (source) to file
SAVE_IMAGE Save image to file
SAVE_LINK Save link to file
-SAVE_SCREEN Save rendered document to file
+SAVE_SCREEN Save buffer to file
SEARCH Search forward
SEARCH_BACK Search backward
SEARCH_FORE Search forward
SEARCH_NEXT Search next regexp
SEARCH_PREV Search previous regexp
SELECT Go to buffer selection panel
-SELECT_MENU Popup buffer selection menu
-SETENV Set environment variable
-SET_OPTION Set option
+SELECT_MENU Pop up buffer selection menu
+SETENV Set environment variable
+SET_OPTION Set option
SHELL Execute shell command
SHIFT_LEFT Shift screen left
SHIFT_RIGHT Shift screen right
SOURCE View HTML source
STOP_IMAGE Stop loading and drawing of images
SUBMIT Submit form
-SUSPEND Stop loading document
+SUSPEND Suspend w3m
TAB_GOTO Open URL on new tab
TAB_GOTO_RELATIVE Open relative URL on new tab
TAB_LEFT Move current tab left
TAB_LINK Open current link on new tab
-TAB_MENU Popup tab selection menu
+TAB_MENU Pop up tab selection menu
TAB_MOUSE Move to tab on mouse cursor (for mouse action)
TAB_RIGHT Move current tab right
UNDO Cancel the last cursor movement
UP Scroll up one line
-VERSION Display version of w3m
+VERSION Display version of w3m
VIEW View HTML source
-VIEW_BOOKMARK View bookmark
+VIEW_BOOKMARK View bookmarks
VIEW_IMAGE View image
-WHEREIS Search forward
-WRAP_TOGGLE Toggle wrap search mode
+WHEREIS Search forward
+WRAP_TOGGLE Toggle search wrap mode
diff --git a/doc/menu.submenu b/doc/menu.submenu
index e55193d..e837f46 100644
--- a/doc/menu.submenu
+++ b/doc/menu.submenu
@@ -39,6 +39,6 @@ menu Link
end
menu Bookmark
- func "Read bookmark (b)" BOOKMARK "bB"
+ func "View bookmarks (b)" BOOKMARK "bB"
func "Add page to bookmark(a)" ADD_BOOKMARK "aA"
end
diff --git a/main.c b/main.c
index 2dd78dc..56301cc 100644
--- a/main.c
+++ b/main.c
@@ -222,7 +222,7 @@ fusage(FILE * f, int err)
#endif /* USE_COLOR */
fprintf(f,
" -N open URL of command line on each new tab\n");
- fprintf(f, " -F automatically render frame\n");
+ fprintf(f, " -F automatically render frames\n");
fprintf(f,
" -cols width specify column width (used with -dump)\n");
fprintf(f,
@@ -261,7 +261,7 @@ fusage(FILE * f, int err)
#else
fprintf(f, " -S squeeze multiple blank lines\n");
#endif
- fprintf(f, " -W toggle wrap search mode\n");
+ fprintf(f, " -W toggle search wrap mode\n");
fprintf(f, " -X don't use termcap init/deinit\n");
fprintf(f,
" -title[=TERM] set buffer name to terminal title string\n");
@@ -2610,7 +2610,7 @@ DEFUN(selBuf, SELECT, "Go to buffer selection panel")
}
/* Suspend (on BSD), or run interactive shell (on SysV) */
-DEFUN(susp, INTERRUPT SUSPEND, "Stop loading document")
+DEFUN(susp, INTERRUPT SUSPEND, "Suspend w3m")
{
#ifndef SIGSTOP
char *shell;
@@ -2941,7 +2941,7 @@ loadLink(char *url, char *target, char *referer, FormList *request)
if (!on_target) /* open link as an indivisual page */
return loadNormalBuf(buf, TRUE);
- if (do_download) /* download (thus no need to render frame) */
+ if (do_download) /* download (thus no need to render frames) */
return loadNormalBuf(buf, FALSE);
if (target == NULL || /* no target specified (that means this page is not a frame page) */
@@ -3070,7 +3070,7 @@ handleMailto(char *url)
}
/* follow HREF link */
-DEFUN(followA, GOTO_LINK, "Go to current link")
+DEFUN(followA, GOTO_LINK, "Follow current link")
{
Anchor *a;
ParsedURL u;
@@ -3994,37 +3994,37 @@ nextY(int d)
}
/* go to the next left anchor */
-DEFUN(nextL, NEXT_LEFT, "Move to next left link")
+DEFUN(nextL, NEXT_LEFT, "Move left to next link")
{
nextX(-1, 0);
}
/* go to the next left-up anchor */
-DEFUN(nextLU, NEXT_LEFT_UP, "Move to next left (or upward) link")
+DEFUN(nextLU, NEXT_LEFT_UP, "Move left (or upward) to next link")
{
nextX(-1, -1);
}
/* go to the next right anchor */
-DEFUN(nextR, NEXT_RIGHT, "Move to next right link")
+DEFUN(nextR, NEXT_RIGHT, "Move right to next link")
{
nextX(1, 0);
}
/* go to the next right-down anchor */
-DEFUN(nextRD, NEXT_RIGHT_DOWN, "Move to next right (or downward) link")
+DEFUN(nextRD, NEXT_RIGHT_DOWN, "Move right (or downward) to next link")
{
nextX(1, 1);
}
/* go to the next downward anchor */
-DEFUN(nextD, NEXT_DOWN, "Move to next downward link")
+DEFUN(nextD, NEXT_DOWN, "Move downward to next link")
{
nextY(1);
}
/* go to the next upward anchor */
-DEFUN(nextU, NEXT_UP, "Move to next upward link")
+DEFUN(nextU, NEXT_UP, "Move upward to next link")
{
nextY(-1);
}
@@ -4276,14 +4276,14 @@ cmd_loadBuffer(Buffer *buf, int prop, int linkid)
}
/* load bookmark */
-DEFUN(ldBmark, BOOKMARK VIEW_BOOKMARK, "Read bookmark")
+DEFUN(ldBmark, BOOKMARK VIEW_BOOKMARK, "View bookmarks")
{
cmd_loadURL(BookmarkFile, NULL, NO_REFERER, NULL);
}
/* Add current to bookmark */
-DEFUN(adBmark, ADD_BOOKMARK, "Add current page to bookmark")
+DEFUN(adBmark, ADD_BOOKMARK, "Add current page to bookmarks")
{
Str tmp;
FormList *request;
@@ -4313,7 +4313,7 @@ DEFUN(adBmark, ADD_BOOKMARK, "Add current page to bookmark")
}
/* option setting */
-DEFUN(ldOpt, OPTIONS, "Option setting panel")
+DEFUN(ldOpt, OPTIONS, "Display option setting panel")
{
cmd_loadBuffer(load_option_panel(), BP_NO_URL, LB_NOLINK);
}
@@ -4416,7 +4416,7 @@ follow_map(struct parsed_tagarg *arg)
#ifdef USE_MENU
/* link menu */
-DEFUN(linkMn, LINK_MENU, "Popup link element menu")
+DEFUN(linkMn, LINK_MENU, "Pop up link element menu")
{
LinkList *l = link_menu(Currentbuf);
ParsedURL p_url;
@@ -4454,19 +4454,19 @@ anchorMn(Anchor *(*menu_func) (Buffer *), int go)
}
/* accesskey */
-DEFUN(accessKey, ACCESSKEY, "Popup accesskey menu")
+DEFUN(accessKey, ACCESSKEY, "Pop up accesskey menu")
{
anchorMn(accesskey_menu, TRUE);
}
/* list menu */
-DEFUN(listMn, LIST_MENU, "Popup link list menu and go to selected link")
+DEFUN(listMn, LIST_MENU, "Pop up link list menu and go to selected link")
{
anchorMn(list_menu, TRUE);
}
DEFUN(movlistMn, MOVE_LIST_MENU,
- "Popup link list menu and move cursor to selected link")
+ "Pop up link list menu and move cursor to selected link")
{
anchorMn(list_menu, FALSE);
}
@@ -4500,7 +4500,7 @@ DEFUN(cooLst, COOKIE, "View cookie list")
#ifdef USE_HISTORY
/* History page */
-DEFUN(ldHist, HISTORY, "View history of URL")
+DEFUN(ldHist, HISTORY, "View browser history")
{
cmd_loadBuffer(historyBuffer(URLHist), BP_NO_URL, LB_NOLINK);
}
@@ -4574,7 +4574,7 @@ DEFUN(svBuf, PRINT SAVE_SCREEN, "Save rendered document to file")
}
/* save source */
-DEFUN(svSrc, DOWNLOAD SAVE, "Save document source to file")
+DEFUN(svSrc, DOWNLOAD SAVE, "Save document (source) to file")
{
char *file;
@@ -4653,13 +4653,13 @@ _peekURL(int only_img)
}
/* peek URL */
-DEFUN(peekURL, PEEK_LINK, "Peek link URL")
+DEFUN(peekURL, PEEK_LINK, "Peek at link URL")
{
_peekURL(0);
}
/* peek URL of image */
-DEFUN(peekIMG, PEEK_IMG, "Peek image URL")
+DEFUN(peekIMG, PEEK_IMG, "Peek at image URL")
{
_peekURL(1);
}
@@ -4673,7 +4673,7 @@ currentURL(void)
return parsedURL2Str(&Currentbuf->currentURL);
}
-DEFUN(curURL, PEEK, "Peek current URL")
+DEFUN(curURL, PEEK, "Peek at current URL")
{
static Str s = NULL;
#ifdef USE_M17N
@@ -5039,13 +5039,13 @@ chkURLBuffer(Buffer *buf)
buf->check_url |= CHK_URL;
}
-DEFUN(chkURL, MARK_URL, "Mark URL-like strings as anchors")
+DEFUN(chkURL, MARK_URL, "Mark URL-like strings as links")
{
chkURLBuffer(Currentbuf);
displayBuffer(Currentbuf, B_FORCE_REDRAW);
}
-DEFUN(chkWORD, MARK_WORD, "Mark current word as anchor")
+DEFUN(chkWORD, MARK_WORD, "Mark current word as link")
{
char *p;
int spos, epos;
@@ -5072,15 +5072,15 @@ chkNMIDBuffer(Buffer *buf)
buf->check_url |= CHK_NMID;
}
-DEFUN(chkNMID, MARK_MID, "Mark Message-ID-like strings as anchors")
+DEFUN(chkNMID, MARK_MID, "Mark Message-ID-like strings as links")
{
chkNMIDBuffer(Currentbuf);
displayBuffer(Currentbuf, B_FORCE_REDRAW);
}
#endif /* USE_NNTP */
-/* render frame */
-DEFUN(rFrame, FRAME, "Render frame")
+/* render frames */
+DEFUN(rFrame, FRAME, "Render frames")
{
Buffer *buf;
@@ -5504,7 +5504,7 @@ process_mouse(int btn, int x, int y)
}
}
-DEFUN(msToggle, MOUSE_TOGGLE, "Toggle activity of mouse")
+DEFUN(msToggle, MOUSE_TOGGLE, "Toggle mouse support")
{
if (use_mouse) {
use_mouse = FALSE;
@@ -5669,7 +5669,7 @@ DEFUN(movMs, MOVE_MOUSE, "Move cursor to mouse cursor (for mouse action)")
#define FRAME_WIDTH 1
#endif
-DEFUN(menuMs, MENU_MOUSE, "Popup menu at mouse cursor (for mouse action)")
+DEFUN(menuMs, MENU_MOUSE, "Pop up menu at mouse cursor (for mouse action)")
{
if (!mouse_action.in_action)
return;
@@ -5719,7 +5719,7 @@ DEFUN(dispVer, VERSION, "Display version of w3m")
disp_message(Sprintf("w3m version %s", w3m_version)->ptr, TRUE);
}
-DEFUN(wrapToggle, WRAP_TOGGLE, "Toggle wrap search mode")
+DEFUN(wrapToggle, WRAP_TOGGLE, "Toggle search wrap mode")
{
if (WrapSearch) {
WrapSearch = FALSE;
@@ -6172,7 +6172,7 @@ DEFUN(reinit, REINIT, "Reload configuration files")
}
DEFUN(defKey, DEFINE_KEY,
- "Define a binding between a key stroke and a user command")
+ "Define a binding between a keystroke and a user command")
{
char *data;
diff --git a/menu.c b/menu.c
index 0f622c1..dfbeabe 100644
--- a/menu.c
+++ b/menu.c
@@ -1338,7 +1338,7 @@ mainMenu(int x, int y)
popupMenu(x, y, &MainMenu);
}
-DEFUN(mainMn, MAIN_MENU MENU, "Popup menu")
+DEFUN(mainMn, MAIN_MENU MENU, "Pop up menu")
{
Menu *menu = &MainMenu;
char *data;
@@ -1366,7 +1366,7 @@ DEFUN(mainMn, MAIN_MENU MENU, "Popup menu")
/* --- SelectMenu --- */
-DEFUN(selMn, SELECT_MENU, "Popup buffer selection menu")
+DEFUN(selMn, SELECT_MENU, "Pop up buffer selection menu")
{
int x = Currentbuf->cursorX + Currentbuf->rootX,
y = Currentbuf->cursorY + Currentbuf->rootY;
@@ -1511,7 +1511,7 @@ smDelBuf(char c)
/* --- SelTabMenu --- */
-DEFUN(tabMn, TAB_MENU, "Popup tab selection menu")
+DEFUN(tabMn, TAB_MENU, "Pop up tab selection menu")
{
int x = Currentbuf->cursorX + Currentbuf->rootX,
y = Currentbuf->cursorY + Currentbuf->rootY;
diff --git a/scripts/w3mhelp-funcdesc.ja.pl.in b/scripts/w3mhelp-funcdesc.ja.pl.in
index 051c888..b0f529e 100644
--- a/scripts/w3mhelp-funcdesc.ja.pl.in
+++ b/scripts/w3mhelp-funcdesc.ja.pl.in
@@ -59,8 +59,8 @@ $charset = 'EUC-JP';
"Mark operation", 'マーク操作',
"Miscellany", 'その他',
"User defined keymaps", 'ユーザ定義',
- "Line-edit mode", '行編集モード',
- "Popup menu", 'メニュー',
+ "Line-editing mode", '行編集モード',
+ "Pop up menu", 'メニュー',
);
1;
diff --git a/scripts/w3mhelp.cgi.in b/scripts/w3mhelp.cgi.in
index 31c0049..157f23e 100644
--- a/scripts/w3mhelp.cgi.in
+++ b/scripts/w3mhelp.cgi.in
@@ -182,7 +182,7 @@ print "<BR>\n<HR WIDTH=80%>\n";
print "<BR>\n<HR WIDTH=80%>\n";
-&show_keymap("Line-edit mode",
+&show_keymap("Line-editing mode",
split(" ", "lineedit_forward lineedit_back lineedit_backspace
lineedit_delete lineedit_kill_after lineedit_kill_before
lineedit_top lineedit_bottom lineedit_prev lineedit_next
@@ -190,7 +190,7 @@ print "<BR>\n<HR WIDTH=80%>\n";
print "<BR>\n<HR WIDTH=80%>\n";
-&show_keymap("Popup menu",
+&show_keymap("Pop up menu",
split(" ", "menu_select menu_close menu_cancel menu_down menu_up
menu_line_up menu_line_down menu_top menu_last menu_next
menu_prev menu_search_fore menu_search_back menu_search_next
diff --git a/w3mhelp-lynx_en.html.in b/w3mhelp-lynx_en.html.in
index 7448877..d073b0f 100644
--- a/w3mhelp-lynx_en.html.in
+++ b/w3mhelp-lynx_en.html.in
@@ -43,20 +43,20 @@ w3m</A>
<table cellpadding=0>
<TR><TD WIDTH=100>RET, C-f, Right arrow<TD>Follow hyperlink
<TR><TD>d, ESC RET<TD>Save link to file
-<TR><TD>u<TD>Peek link URL
-<TR><TD>i<TD>Peek image URL
+<TR><TD>u<TD>Peek at link URL
+<TR><TD>i<TD>Peek at image URL
<TR><TD>I<TD>View inline image
<TR><TD>ESC I<TD>Save inline image to file
-<TR><TD>:<TD>Mark URL-like strings as anchors
-<TR><TD>ESC :<TD>Mark Message-ID-like strings as news anchors
-<TR><TD>c<TD>Peek current URL
+<TR><TD>:<TD>Mark URL-like strings as links
+<TR><TD>ESC :<TD>Mark Message-ID-like strings as links
+<TR><TD>c<TD>Peek at current URL
<TR><TD>=<TD>Display information about current document
-<TR><TD>C-h<TD>View history of URL
-<TR><TD>F<TD>Render frame
+<TR><TD>C-h<TD>View browser history
+<TR><TD>F<TD>Render frames
<TR><TD>M<TD>Browse current document using external browser
-(use 2M and 3M to invoke second and third browser)
+(prefix 2, 3, ..., or 9 to invoke alternate configured browsers, e.g. 3 M)
<TR><TD>ESC M<TD>Browse link using external browser
-(use 2ESC M and 3ESC M to invoke second and third browser)
+(prefixed as above, e.g. 3ESC M)
</table>
<H2>File/Stream operation</H2>
@@ -98,7 +98,7 @@ w3m</A>
<table cellpadding=0>
<TR><TD WIDTH=100>/, C-s<TD>Search forward
<TR><TD>n<TD>Search next
-<TR><TD>w<TD>Toggle wrap search mode
+<TR><TD>w<TD>Toggle search wrap mode
</table>
<H2>Mark operation</H2>
@@ -121,7 +121,7 @@ w3m</A>
<TR><TD>Q<TD>Quit without confirmation
</table>
-<H2>Line-edit mode</H2>
+<H2>Line-editing mode</H2>
<table cellpadding=0>
<TR><TD WIDTH=100>C-f<TD>Move cursor forward
<TR><TD>C-b<TD>Move cursor backward
diff --git a/w3mhelp-w3m_en.html.in b/w3mhelp-w3m_en.html.in
index eb46e8a..a692142 100644
--- a/w3mhelp-w3m_en.html.in
+++ b/w3mhelp-w3m_en.html.in
@@ -47,21 +47,21 @@ w3m</A>
<table cellpadding=0>
<TR><TD WIDTH=100>RET<TD>Follow hyperlink
<TR><TD>a, ESC RET<TD>Save link to file
-<TR><TD>u<TD>Peek link URL
-<TR><TD>i<TD>Peek image URL
+<TR><TD>u<TD>Peek at link URL
+<TR><TD>i<TD>Peek at image URL
<TR><TD>I<TD>View inline image
<TR><TD>ESC I<TD>Save inline image to file
-<TR><TD>:<TD>Mark URL-like strings as anchors
-<TR><TD>ESC :<TD>Mark Message-ID-like strings as news anchors
-<TR><TD>c<TD>Peek current URL
+<TR><TD>:<TD>Mark URL-like strings as links
+<TR><TD>ESC :<TD>Mark Message-ID-like strings as links
+<TR><TD>c<TD>Peek at current URL
<TR><TD>=<TD>Display information about current document
<TR><TD>C-g<TD>Show current line number
-<TR><TD>C-h<TD>View history of URL
-<TR><TD>F<TD>Render frame
+<TR><TD>C-h<TD>View browser history
+<TR><TD>F<TD>Render frames
<TR><TD>M<TD>Browse current document using external browser
-(use 2M and 3M to invoke second and third browser)
+(prefix 2, 3, ..., or 9 to invoke alternate configured browsers, e.g. 3 M)
<TR><TD>ESC M<TD>Browse link using external browser
-(use 2ESC M and 3ESC M to invoke second and third browser)
+(prefixed as above, e.g. 3ESC M)
</table>
<H2>File/Stream operation</H2>
@@ -105,7 +105,7 @@ w3m</A>
<TR><TD>?,C-r<TD>Search backward
<TR><TD>n<TD>Search next
<TR><TD>N<TD>Search previous
-<TR><TD>C-w<TD>Toggle wrap search mode
+<TR><TD>C-w<TD>Toggle search wrap mode
</table>
<H2>Dictionary look-up</H2>
@@ -134,7 +134,7 @@ w3m</A>
<TR><TD>Q<TD>Quit without confirmation
</table>
-<H2>Line-edit mode</H2>
+<H2>Line-editing mode</H2>
<table cellpadding=0>
<TR><TD WIDTH=100>C-f<TD>Move cursor forward
<TR><TD>C-b<TD>Move cursor backward