aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorMarkus Hiereth <post@hiereth.de>2016-08-08 11:23:56 +0000
committerTatsuya Kinoshita <tats@debian.org>2016-08-08 11:23:56 +0000
commit45d40611a8d35ba395e5082688a783dfa886b588 (patch)
tree5d9b19c673a711dba1aaec0c9c58286370f99a1d /doc
parentUpdate FAQ.html in English and German (diff)
downloadw3m-45d40611a8d35ba395e5082688a783dfa886b588.tar.gz
w3m-45d40611a8d35ba395e5082688a783dfa886b588.zip
Update MANUAL.html in English and German
Origin: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=772341#90
Diffstat (limited to 'doc')
-rw-r--r--doc/MANUAL.html2354
1 files changed, 1269 insertions, 1085 deletions
diff --git a/doc/MANUAL.html b/doc/MANUAL.html
index 44379e9..f0710a7 100644
--- a/doc/MANUAL.html
+++ b/doc/MANUAL.html
@@ -1,23 +1,19 @@
<!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 manual
- </title>
- </head>
- <body>
+ <head>
+ <title>w3m manual</title>
+ <style>
+ span.mono {
+ font-family:mono;
+ }
+ </style>
+ <meta http-equiv="content-type" content="text/html;charset=UTF-8">
+ </head>
+ <body>
<!--
-Todo:
-words anchor, link, hyperlink are used with the meaning link. Decide which one shall be prefered and used throughout the documentation
--->
- <!--
-Todo:
-Keybindigs: Check whether there are keybindings that contain SHIFT-Letter which shall be replaced with the majuscule. Having this notation all over the documentation, this shall be noted in the introduction paragraph of section "Key bindings"
--->
- <!--
-insertions tagged with "mh 2016-03-29" come from the latest version of manual page w3m (1)
--->
+insertions tagged with "mh 2016-03-29" and "mh 2016-06-11" come from the latest version of manual page w3m (1)
+ -->
+
<h1>w3m MANUAL</h1>
<div align="right">
Akinori Ito<br>
@@ -37,32 +33,36 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa
</li>
<li>
<a href="#Color">
- Document colors
+ Document Colors
</a>
</li>
<li>
- <a href="#Key:orig">
- Key bindings
+ <a href="#Functions">
+ Functions and Key bindings
</a>
</li>
+<!-- mh 2016-06-13 obsolete
<li>
<a href="#Key:lynx">
Lynx-like key bindings
</a>
</li>
+-->
<li>
<a href="#Mouse">
- Mouse operation
+ Mouse Operation
</a>
</li>
+<!-- mh 2016-06-13 obsolete
<li>
<a href="#Key:custom">
Key customization
</a>
</li>
+ -->
<li>
<a href="#LocalCGI">
- Local CGI
+ Local CGI scripts
</a>
</li>
</ul>
@@ -81,8 +81,9 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa
<p>
Command line usage is
</p>
+<!-- mh 2016-08-06 invocation adapted to w3m(1). w3m accepts several options and several targets -->
<pre>
- w3m [options] [file|URL]
+ w3m [option]... [file|URL]...
</pre>
<p>
If you specify filenames/URLs on the command line, these documents
@@ -94,143 +95,118 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa
Options include:
</p>
<dl>
- <dt>
- +<i>number</i>
+<h3>General options</h3>
+ <dt>
+ -B
</dt>
<dd>
<p>
- Move to the specified line-number.
+ <!-- mh 2016-03-29-->
+ with no other target defined, use the bookmark page for startup
</p>
</dd>
- <dt>
- -t <i>width</i>
- <!--mh 2016-03-29 -t <i>num</i>-->
+ <dt>
+ -M
</dt>
<dd>
<p>
- Specify tab width. Default is 8.
- <!--mh 2016-03-29 set tab width to num columns. No effect on stdout-->
+ <!-- mh 2016-03-29-->
+ monochrome display
</p>
</dd>
<dt>
- -r
+ -no-mouse
</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>.
-<!-- mh 2016-03-29
-use caret notation to display special escape characters (such as ANSI escapes or nroff-style backspaces for bold and underlined characters) instead of processing them
--->
+ deactivate mouse support.
</p>
</dd>
<dt>
- -l <i>number</i>
+ -num
</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.
+ <!-- mh 2016-03-29-->
+ display each line's number
+
</p>
</dd>
+<!-- mh 2016-08-06 commented out. As implementation is not verified.
<dt>
- -O <i>charset</i>
+ -ppc <i>num</i>
</dt>
<dd>
<p>
- Specify display/output charset.
-<!-- mh 2016-03-29
-user defined character encoding of output data
--->
+ width of <i>num</i> pixels per character. Range of 4.0 to 32.0,
+ default 8.0. Larger values will make tables
+ narrower. (Implementation not verified)
</p>
</dd>
+-->
<dt>
- -I <i>charset</i>
+ -v
</dt>
<dd>
<p>
- Specify document charset.
-<!-- mh 2016-03-29
-user defined character encoding of input data
--->
+ <!-- mh 2016-03-29-->
+ with no other target defined, welcome users with a built-in page
</p>
</dd>
<dt>
- -T <i>type</i>
+ -W
</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:
+ <!-- mh 2016-03-29-->
+ toggle wrapping mode in searches
</p>
- <p>
- Read HTML document from standard input and display it
- </p>
-<pre>
- cat example.html | w3m -T text/html
-</pre>
- <p>
- Display HTML source
- </p>
-<pre>
- w3m -T text/plain example.html
-</pre>
</dd>
<dt>
- -m
+ -X
</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.
-<!-- mh 2016-03-29
-Render the body of Usenet messages according to the header <q>Content-type</q>
--->
+ upon exit, do not reinitialize the terminal.
</p>
</dd>
<dt>
- -v
+ +<i>num</i>
</dt>
<dd>
- <p>
- Show w3m's startup page.
-<!-- mh 2016-03-29
-with no other target defined, welcome users with a built-in page
--->
+ <p><!--mh 2016-06-11 -->
+ go to line <i>num</i>; only effective for numbers larger
+ than the number of lines in the terminal
</p>
</dd>
+<h3>Browser options</h3>
<dt>
- -B
+ -cols <i>num</i>
</dt>
<dd>
<p>
- Show w3m's bookmarks page.
-<!-- mh 2016-03-29
-with no other target defined, use the bookmark page for startup
--->
+ <!-- mh 2016-06-11 -->
+ with stdout as destination; HTML is rendered to lines of <i>num</i>
+ characters
</p>
</dd>
<dt>
- -bookmark <i>file</i>
+ -cookie
</dt>
<dd>
<p>
- Specify a custom bookmarks file.
+ <!-- mh 2016-03-29-->
+ use stored cookies and accept new ones
</p>
</dd>
<dt>
- -M
+ -no-cookie
</dt>
<dd>
<p>
- Monochrome display mode.
-<!-- mh 2016-03-29
-monochrome display
--->
+ <!-- mh 2016-03-29-->
+ neither use stored cookies nor accept new ones
+
</p>
</dd>
<dt>
@@ -238,250 +214,238 @@ monochrome display
</dt>
<dd>
<p>
- Automatically render HTML frames.
-<!-- mh 2016-03-29
-render frames
--->
+ <!-- mh 2016-03-29-->
+ render frames
</p>
</dd>
<dt>
- -s
+ -no-graph
</dt>
<dd>
<p>
- Squeeze blank lines.
-<!-- mh 2016-03-29
-squeeze multiple blank lines into one
--->
+ <!-- mh 2016-03-29-->
+ do not use graphic characters for drawing HTML table and frame
+ borders
</p>
</dd>
<dt>
- -X
+ -header <i>string</i>
</dt>
<dd>
<p>
- Upon exit, do not reinitialize the terminal.
+ <!-- mh 2016-03-29-->
+ append <i>string</i> to the HTTP(S) request. Expected to match
+ the header syntax <span class="mono">"Variable: Value"</span>
</p>
</dd>
<dt>
- -W
+ -m
</dt>
<dd>
<p>
- Toggle wrapping mode in searches.
+ 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.
<!-- mh 2016-03-29
-toggle wrapping in searches
+Render the body of Usenet messages according to the header <q>Content-type</q>
-->
-
</p>
</dd>
<dt>
- -o <i>option</i>=<i>value</i>
+ -no-proxy
</dt>
<dd>
<p>
- Specify option. The available option names and values are the
- same as in ~/.w3m/config.
-<!-- mh 2016-03-29
-modify one configuration item with an explicitly given value; without option=value, equivalent to -show-option
--->
- </p>
+ <!-- mh 2016-06-11-->
+ do not use proxy
+ </p>
</dd>
<dt>
- -cookie
+ -post <i>file</i>
</dt>
<dd>
- <p>
- Process cookies.
-<!-- mh 2016-03-29
-use stored cookies and accept new ones
--->
-
+ <p><!--funktionierend 2016-06-28T08:22>-->
+ use POST method to upload data defined in <i>file</i>. The
+ syntax to be used is <span class="mono">"var1=value1[&amp;var2=value2]…"</span>
</p>
</dd>
+<h3>Text pager options</h3>
<dt>
- -no-cookie
+ -l <i>num</i>
</dt>
<dd>
<p>
- Don't process cookies.
-<!-- mh 2016-03-29
-neither use stored cookies nor accept new ones
--->
-
+ <!-- mh2016-06-11-->
+ number of lines preserved internally when receiving plain text
+ from stdin (default 10,000)
</p>
</dd>
<dt>
- -num
+ -r
</dt>
<dd>
<p>
- Show line-numbers.
-<!-- mh 2016-03-29
-display each line's number
--->
+ <!-- mh 2016-03-29 -->
+ use caret notation to display special escape characters (such as
+ ANSI escapes or nroff-style backspaces for bold and underlined
+ characters) instead of processing them
</p>
</dd>
<dt>
- -dump
+ -s
</dt>
<dd>
<p>
- Read document specified by URL and dump page rendered as text
- into standard output. A width of 80 columns is used unless option
- -cols sets another value.
-
-<!-- mh 2016-03-29
-dump rendered page into stdout. Set implicitly when output is directed to a file or pipe
--->
-
+ <!-- mh 2016-03-29-->
+ squeeze multiple blank lines into one
</p>
</dd>
- <dt>
- -cols <i>width</i>
+
+ <dt>
+ <!--mh 2016-03-29 --> -t <i>num</i>
</dt>
<dd>
<p>
- Specify document width. Used with -dump option.
+ <!--mh 2016-03-29--> set tab width to <i>num</i> columns. No effect on stdout
</p>
</dd>
+<h3>Data type/encoding options</h3>
<dt>
- -ppc <i>count</i>
+ -I <i>charset</i>
</dt>
<dd>
<p>
- Specify the number of pixels per character (default 8.0). Larger
- values will make tables narrower.
-<!-- mh 2016-03-29
-width of num pixels per character. Range of 4.0 to 32.0, default 8.0. Larger
-values will make tables narrower. (Implementation not verified)
--->
+ <!-- mh 2016-03-29-->
+ user defined character encoding of input data
</p>
</dd>
<dt>
- -dump_source
+ -O <i>charset</i>
</dt>
<dd>
<p>
- Read document specified by URL and dump the source.
-<!-- mh 2016-03-29
-dump the page's source code into stdout
--->
+ <!-- mh 2016-03-29 -->
+ user defined character encoding of output data
</p>
</dd>
<dt>
- -dump_head
+ -T <i>type</i>
</dt>
<dd>
+ <p>
+ <!-- mh 2016-06-11-->
+ explicit characterization of input data by MIME 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 document specified by URL and dump headers.
-<!-- mh 2016-03-29
-dump response of a HEAD request for a URL into stdout
--->
+ Read HTML document from standard input and display it
</p>
+<pre>
+ cat example.html | w3m -T text/html
+</pre>
+ <p>
+ Display HTML source
+ </p>
+<pre>
+ w3m -T text/plain example.html
+</pre>
</dd>
+<h3>Options for data output, followed by immediate exit</h3>
<dt>
- -dump_both
+ -dump
</dt>
<dd>
- <p>
- Read document specified by URL and dump headers and the source.
-<!-- mh 2016-03-29
-dump HEAD, and source code for a URL into stdout
--->
-
- </p>
+ <p>
+ read document specified by URL and dump page rendered as text
+ into standard output.
+ <!-- mh 2016-03-29 -->
+ Is set implicitly when output is directed
+ to a file or pipe. A width of 80 columns is used unless option
+ -cols sets another value.
+ </p>
</dd>
<dt>
- -dump_extra
+ -dump_source
</dt>
<dd>
<p>
- Read document specified by URL and dump extra informations,
- headers, and the source.
-<!-- mh 2016-03-29
-dump HEAD, source code, and extra information for a URL into
-stdout
--->
-
+ <!-- mh 2016-03-29-->
+ dump the page's source code into stdout
</p>
</dd>
<dt>
- -post <i>file</i>
+ -dump_head
</dt>
<dd>
<p>
- Use POST method with file content.
-<!-- mh 2016-03-29
-use POST method to upload data defined in <q>file</q>. The syntax to be
- used is var1=value1[&amp;var2=value2]...
--->
-
+ <!-- mh 2016-03-29-->
+ dump response of a HEAD request for a URL into stdout
</p>
</dd>
<dt>
- -header <i>string</i>
+ -dump_both
</dt>
<dd>
<p>
- Insert string as a header.
-<!-- mh 2016-03-29
-append <q>string</q> to the HTTP(S) request. Expected to match the
-header syntax Variable: Value
--->
+ <!-- mh 2016-03-29-->
+ dump HEAD, and source code for a URL into stdout
</p>
</dd>
<dt>
- -no-proxy
+ -dump_extra
</dt>
<dd>
<p>
- Don't use proxy server.
+ <!-- mh 2016-03-29-->
+ dump HEAD, source code, and extra information for a URL into
+ stdout
</p>
</dd>
+
+<h3>Options for overriding default settings and resources</h3>
+
<dt>
- -no-graph
+ -bookmark <i>file</i>
</dt>
<dd>
<p>
- Use ASCII characters to draw frames rather than graphical ones.
-<!-- mh 2016-03-29
-do not use graphic characters for drawing HTML table and
-frame borders
--->
-
+ <!-- mh 2016-03-29-->
+ use <i>file</i> instead of the default bookmark.html file
</p>
</dd>
<dt>
- -no-mouse
+ -config <i>file</i>
</dt>
<dd>
<p>
- Deactivate mouse support.
+ <!--mh 2016-06-11-->
+ use <i>file</i> instead of the default configuration file
</p>
</dd>
<dt>
- -config <i>file</i>
+ -o <i>option</i>=<i>value</i>
</dt>
<dd>
<p>
- Specify config file.
+ <!-- mh 2016-03-29-->
+ modify one configuration item with an explicitly given value; without <i>option=value</i>, equivalent to <i>-show-option</i>
</p>
</dd>
</dl>
<hr>
<h2 id="Color">
- Document colors
+ Document Colors
</h2>
<p>
- Links and images are displayed as follows.
+ Hyperlinks and images are displayed as follows.
</p>
<div align="center">
<table border="1">
<tr>
<th>
- &nbsp;
</th>
<th>
Color mode
@@ -492,7 +456,7 @@ frame borders
</tr>
<tr>
<td>
- links
+ Hyperlinks
</td>
<td>
blue
@@ -503,7 +467,7 @@ frame borders
</tr>
<tr>
<td>
- inline images
+ Inline images
</td>
<td>
green
@@ -514,7 +478,7 @@ frame borders
</tr>
<tr>
<td>
- form input
+ Form input
</td>
<td>
red
@@ -526,1565 +490,1796 @@ frame borders
</table>
</div>
<p>
- These colors can be customized using the option setting command
- <q>o</q>.
+ These colors can be customized using the options setting command
+ <i>o</i>.
</p>
<hr>
- <h2 id="Key:orig">
- Key bindings
+ <h2 id="Functions">
+ Functions and Key bindings
</h2>
+
+ <p>
+ After invocation, you can control w3m by typing in functions by name
+ or with keystroke combinations bound to a function. There are
+ default key bindings.
+<!-- mh 2016-06-13 obsolete
+ If you prefer using Lynx-like
+ key bindings, make w3m start with the respective keymap file keymap.lynx. (see w3m (1)).-->
+ </p>
<!--
- TODO: reorganise this whole thing into one big table of
- FUNCTIONNAME | description | default-binding | Lynxlike-binding
-!-->
+ <h2 id="Key:custom">
+ Key customization
+ </h2>
+-->
<p>
- After invoking w3m, you can control it with keyboard commands.
+ You can customize the key bindings (except those for menu
+ operations and line-editing) in a ~/.w3m/keymap file. For example,
</p>
+
+<pre>
+ keymap C-o NEXT_PAGE
+</pre>
+
<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 M</q>
- simply means <q>2</q> followed by <q>M</q>.
+ binds the command <span class="mono">NEXT_PAGE</span> (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 as examples: <a href="keymap.default">keymap.default</a>
+ and <a href="keymap.lynx">keymap.lynx</a>.
</p>
-<!--
-Correction:
-The two equivalents to the meta-key are pressing simultaneously the ALT-key or pressing the ESC-key first and then other mentioned keys.
--->
- <h3>
- In-page navigation
- </h3>
- <table>
- <tr>
- <td width="100">
+
+ <p>
+ Throughout, the <i>C-</i> and <i>M-</i> notations indicate the
+ modifiers <i>control</i> and <i>meta</i>. The <i>ALT</i>-key
+ replaces the latter whereas pressing the <i>ESC</i>-key toggles
+ between <i>meta</i>-modified and simple keystrokes. The minus
+ indicates pressing the keys simultaneously wheras a space
+ represents that one key is pressed after the other, i.e. <i>2 M</i>
+ simply means <i>2</i> followed by <i>M</i>.
+ </p>
+
+
+ <table border="1" width="100%">
+ <colgroup>
+ <col width="20%">
+ <col width="20%">
+ <col width="20%">
+ <col width="40%">
+ </colgroup>
+ <tr>
+ <th rowspan="2">
+ Function
+ </th>
+ <th colspan="2">Key binding
+ </th>
+ <th rowspan="2">
+ Description
+ </th>
+ </tr>
+ <tr>
+ <th>
+ Default
+ </th>
+ <th>
+ Lynx-like
+ </th>
+ </tr>
+ <tr>
+ <td colspan="4">
+ <h3>In-page navigation</h3>
+</td>
+ </tr>
+ <tr>
+ <td>
+ NEXT_PAGE
+ </td>
+ <td>
SPC, C-v, +, PGDN
</td>
<td>
- Forward page
+ SPC, C-v, +
+ </td>
+ <td>
+ Scroll one page downwards
</td>
</tr>
<tr>
+ <td>
+ PREVIOUS_PAGE
+ </td>
<td>
b, M-v, -, PGUP
</td>
<td>
- Backward page
+ b, M-v, -
+ </td>
+ <td>
+ Scroll one page upwards
</td>
</tr>
<tr>
+ <td>
+ MOVE_RIGHT
+ </td>
<td>
l, C-f, RIGHT
</td>
<td>
- Cursor right
+ l
+ </td>
+ <td>
+ Move cursor right (with a half-screen shift at the screen edge)
</td>
</tr>
<tr>
+ <td>
+ MOVE_LEFT
+ </td>
<td>
h, C-b, LEFT
</td>
<td>
- Cursor left
- </td>
- </tr>
- <tr>
- <td>
- j, C-n, DOWN
+ h
</td>
<td>
- Cursor down
+ Move cursor left (with a half-screen shift at the screen edge)
</td>
</tr>
<tr>
+ <td>
+ MOVE_DOWN
+ </td>
<td>
- k, C-p, UP
- </td>
- <td>
- Cursor up
+ j, C-n, DOWN
</td>
- </tr>
- <tr>
<td>
- J
+ j
</td>
<td>
- Scroll screen up one line
+ Move cursor down (with a one-line scroll at the screen edge)
</td>
</tr>
<tr>
+ <td>
+ MOVE_UP
+ </td>
<td>
- K
- </td>
- <td>
- Scroll screen down one line
+ k, C-p, UP
</td>
- </tr>
- <tr>
<td>
- ^, C-a
+ k
</td>
<td>
- Go to the beginning of line
+ Move cursor up (with a one-line scroll at the screen edge)
</td>
</tr>
<tr>
+ <td>
+ UP
+ </td>
<td>
- $, C-e
- </td>
- <td>
- Go to the end of line
+ J
</td>
- </tr>
- <tr>
<td>
- w
+ J
</td>
<td>
- Go to the next word
+ Scroll the screen up one line
</td>
</tr>
<tr>
+ <td>
+ DOWN
+ </td>
<td>
- W
- </td>
- <td>
- Go to the previous word
+ K
</td>
- </tr>
- <tr>
<td>
- &gt;
+ K
</td>
<td>
- Shift screen right
+ Scroll the screen down one line
</td>
</tr>
<tr>
+ <td>
+ LINE_BEGIN
+ </td>
<td>
- &lt;
- </td>
- <td>
- Shift screen left
+ ^, C-a
</td>
- </tr>
- <tr>
<td>
- .
+ ^
</td>
<td>
- Shift screen one column right
+ Go to the beginning of the line
</td>
</tr>
<tr>
+ <td>
+ LINE_END
+ </td>
<td>
- ,
- </td>
- <td>
- Shift screen one column left
+ $, C-e
</td>
- </tr>
- <tr>
<td>
- g, M-&lt;, HOME
+ $
</td>
<td>
- Go to the first line
+ Go to the end of the line
</td>
</tr>
<tr>
+ <td>
+ NEXT_WORD
+ </td>
<td>
- G, M-&gt;, END
+ w
</td>
<td>
- Go to the last line
+ w
</td>
- </tr>
- <tr>
<td>
- M-g
- </td>
- <td>
- Go to the specified line
+ Move to the next word
</td>
</tr>
<tr>
+ <td>
+ PREVIOUS_WORD
+ </td>
<td>
- Z
- </td>
- <td>
- Center on cursor column
+ W
</td>
- </tr>
- <tr>
<td>
- z
+ W
</td>
<td>
- Center on cursor line
+ Move to the previous word
</td>
</tr>
<tr>
+ <td>
+ SHIFT_RIGHT
+ </td>
<td>
- TAB
- </td>
- <td>
- Move to the next hyperlink
+ >
</td>
- </tr>
- <tr>
<td>
- C-u, M-TAB
+ >
</td>
<td>
- Move to the previous hyperlink
+ Shift screen right
</td>
</tr>
<tr>
+ <td>
+ SHIFT_LEFT
+ </td>
<td>
- [
- </td>
- <td>
- Move to the first hyperlink
+ <
</td>
- </tr>
- <tr>
<td>
- ]
+ <
</td>
<td>
- Move to the last hyperlink
+ Shift screen left
</td>
</tr>
- </table>
- <h3>Hyperlink operation</h3>
- <table>
<tr>
- <td width="100">
- C-j, C-m, RET
- </td>
+ <td>
+ RIGHT
+ </td>
<td>
- Follow hyperlink
+ .
</td>
- </tr>
- <tr>
<td>
- a, M-RET
+ .
</td>
<td>
- Save link to file
+ Shift screen one column right
</td>
</tr>
<tr>
+ <td>
+ LEFT
+ </td>
<td>
- u
- </td>
- <td>
- Show link URL
+ ,
</td>
- </tr>
- <tr>
<td>
- i
+ ,
</td>
<td>
- Show image URL
+ Shift screen one column left
</td>
</tr>
<tr>
+ <td>
+ BEGIN
+ </td>
<td>
- I
- </td>
- <td>
- View inline image
+ g, M-<, HOME
</td>
- </tr>
- <tr>
<td>
- M-I
+ C-a, M-<
</td>
<td>
- Save inline image to file
+ Go to the first line
</td>
</tr>
<tr>
+ <td>
+ END
+ </td>
<td>
- :
- </td>
- <td>
- Mark URL-like strings as hyperlinks
+ G, M->, END
</td>
- </tr>
- <tr>
<td>
- M-:
+ C-e, M->
</td>
<td>
- Mark Message-ID-like strings as links
+ Go to the last line
</td>
</tr>
<tr>
+ <td>
+ GOTO_LINE
+ </td>
<td>
- c
- </td>
- <td>
- Show current URL
+ M-g
</td>
- </tr>
- <tr>
<td>
- =
+ G
</td>
<td>
- Show information about current document
+ Go to the specified line
</td>
</tr>
<tr>
+ <td>
+ LINE_INFO
+ </td>
<td>
C-g
</td>
<td>
- Show current position in page
- </td>
- </tr>
- <tr>
- <td>
- C-h
+ C-g
</td>
<td>
- Show browsing history
+ Display current position in document
</td>
</tr>
<tr>
+ <td>
+ CENTER_H
+ </td>
<td>
- M
- </td>
- <td>
- Browse current document using external browser (prefix 2, 3, ...,
- or 9 to invoke alternate configured browsers, e.g. 3 M)
+ Z
</td>
- </tr>
- <tr>
+<!--Correction by mh 2014-04-06
+Description for keybinding of z and Z had been mingled
+-->
<td>
- M-M
+ Z
</td>
<td>
- Browse link using external browser (prefixed as above, e.g.
- 3 M-M)
+ Center screen right and left of the cursor column
</td>
</tr>
- </table>
- <h3>
- Bookmark management
- </h3>
- <table>
<tr>
- <td width="100">
- M-b
- </td>
+ <td>
+ CENTER_V
+ </td>
<td>
- Go to the bookmarks page
+ z
</td>
- </tr>
- <tr>
<td>
- M-a
+ z
</td>
<td>
- Bookmark current page
+ Center screen above and below the cursor line
</td>
</tr>
- </table>
- <h3>
- File/stream operation
- </h3>
- <table>
<tr>
- <td width="100">
- U
- </td>
+ <td>
+ NEXT_LINK
+ </td>
<td>
- Open new URL
+ TAB
</td>
- </tr>
- <tr>
<td>
- V
+ TAB, C-n, DOWN
</td>
<td>
- Open new file
+ Move to the next hyperlink
</td>
</tr>
<tr>
+ <td>
+ PREVIOUS_LINK
+ </td>
<td>
- @
- </td>
- <td>
- Execute shell command and view output
+ M-TAB, C-u
</td>
- </tr>
- <tr>
<td>
- #
+ M-TAB, C-u, C-p, UP
</td>
<td>
- Execute shell command and browse output
+ Move to the previous hyperlink
</td>
+<!-- Annotion mh 2016-04-06
+Keybinding description for C-g had been moved as it did not fit to "Hyperlink operation" and position in the default and lynx-like series differed
+ -->
</tr>
- </table>
- <h3>
- Content operations
- </h3>
- <table>
<tr>
- <td width="100">
- v
- </td>
+ <td>
+ LINK_BEGIN
+ </td>
<td>
- Toggle viewing as text or rendered HTML
+ [
</td>
- </tr>
- <tr>
<td>
- F
+ [
</td>
<td>
- Toggle rendering HTML frames
+ Move to the first hyperlink
</td>
</tr>
<tr>
+ <td>
+ LINK_END
+ </td>
<td>
- C-l
+ ]
</td>
<td>
- Redraw screen
- </td>
- </tr>
- <tr>
- <td>
- R
+ ]
</td>
<td>
- Reload
+ Move to the last hyperlink
</td>
</tr>
+<tr>
+<td>MOVE_LIST_MENU</td>
+<td>M-m</td>
+<td>M-m</td>
+<td>Pop up menu to navigate between hyperlinks</td>
+</tr>
+<!-- </table>-->
+ <tr>
+ <td colspan="4">
+ <h3>Hyperlink Operations</h3>
+ </td>
+ </tr>
+<!-- <table>-->
<tr>
+ <td>
+ GOTO_LINK
+ </td>
<td>
- E
- </td>
- <td>
- Edit local source
+ C-j, C-m, RET
</td>
- </tr>
- <tr>
- <td>
- M-e
+ <td width="100">
+ C-f, C-j, C-m, RET, RIGHT
</td>
<td>
- Edit rendered copy of page
+ Follow current hyperlink in a new buffer
</td>
</tr>
+<tr>
+<td>LIST_MENU</td>
+<td>M-l</td>
+<td>M-l</td>
+<td>Pop up hyperlink menu and select one to be followed</td>
+</tr>
<tr>
+ <td>
+ SAVE_LINK
+ </td>
<td>
- M-s
- </td>
- <td>
- Save source
+ a, M-RET
</td>
- </tr>
- <tr>
<td>
- S
+ d, M-RET
</td>
<td>
- Save rendered copy of page
+ Save the hyperlink target
</td>
</tr>
- </table>
- <h3>
- Buffer/tab navigation
- </h3>
- <table>
<tr>
- <td width="100">
- B
- </td>
+ <td>
+ PEEK_LINK
+ </td>
<td>
- Go back, <q>popping</q> the buffer stack
+ u
</td>
- </tr>
- <tr>
<td>
- s
+ u
</td>
<td>
- Show buffer-stack menu
+ Show target address
</td>
</tr>
<tr>
+ <td>
+ PEEK_IMG
+ </td>
<td>
- M-t
- </td>
- <td>
- Show tab menu
+ i
</td>
- </tr>
- <tr>
<td>
- T
+ i
</td>
<td>
- Open current page as new tab
+ Show image address
</td>
</tr>
<tr>
+ <td>
+ VIEW_IMAGE
+ </td>
<td>
- C-t
- </td>
- <td>
- Open link as new tab
+ I
</td>
- </tr>
- <tr>
<td>
- }
+ I
</td>
<td>
- Switch to next tab
+ Display image in viewer
</td>
</tr>
<tr>
+ <td>
+ SAVE_IMAGE
+ </td>
<td>
- {
- </td>
- <td>
- Switch to previous tab
+ M-I
</td>
- </tr>
- <tr>
<td>
- C-q
+ M-I
</td>
<td>
- Close current tab
+ Save inline image
</td>
</tr>
- </table>
- <h3>
- Search
- </h3>
- <table>
+<tr>
+<td>MARK_WORD</td>
+<td>;</td>
+<td>;</td>
+<td>Turn current word into hyperlink</td>
+</tr>
<tr>
- <td width="100">
- /
- </td>
+ <td>
+ MARK_URL
+ </td>
<td>
- Search forward
+ :
</td>
- </tr>
- <tr>
<td>
- ?
+ :
</td>
<td>
- Search backward
+ Turn URL-like strings into hyperlinks
</td>
</tr>
<tr>
- <td width="100">
- C-s
- </td>
+ <td>
+ MARK_MID
+ </td>
<td>
- Incremental search forward
+ M-:
</td>
- </tr>
- <tr>
<td>
- C-r
+ M-:
</td>
<td>
- Incremental search backward
+<!-- changed due to mail dated Mon, 04 Apr 2016 00:47:09 +0900 (JST)
+from Tatsuya Kinoshita -->
+ Turn Message-ID-like strings into hyperlinks
</td>
</tr>
<tr>
+ <td>
+ PEEK
+ </td>
<td>
- n
- </td>
- <td>
- Next match
+ c
</td>
- </tr>
- <tr>
<td>
- N
+ c
</td>
<td>
- Previous match
+ Show current address
</td>
</tr>
<tr>
+ <td>
+ INFO
+ </td>
<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
+ Display information about the current document
</td>
</tr>
<tr>
+ <td>
+ HISTORY
+ </td>
<td>
- M-p
- </td>
- <td>
- Go to the previous mark
+ C-h
</td>
- </tr>
- <tr>
<td>
- M-n
+ C-h
</td>
<td>
- Go to the next mark
+ Show browsing history
</td>
</tr>
<tr>
+ <td>
+ EXTERN
+ </td>
<td>
- "
+ M
</td>
<td>
- Mark all occurrences of a regular expression
- </td>
- </tr>
- </table>
- <h3>
- Miscellany
- </h3>
- <table>
- <tr>
- <td width="100">
- !
+ M
</td>
<td>
- Execute shell command
+ Browse current document using external browser (prefix 2, 3, ...,
+ or 9 to invoke alternate configured browsers, e.g. 3 M)
</td>
</tr>
<tr>
+ <td>
+ EXTERN_LINK
+ </td>
<td>
- M-c
- </td>
- <td>
- Invoke w3m function
+ M-M
</td>
- </tr>
- <tr>
<td>
- H
+ M-M
</td>
<td>
- Show help panel
+ Browse link using external browser (prefixed as above, e.g.
+ 3 M-M)
</td>
</tr>
- <tr>
- <td>
- o
- </td>
+<!-- </table>-->
+ <tr>
+ <td colspan="4">
+ <h3>Bookmark management</h3>
+ </td>
+ </tr>
+<!-- <table>-->
+ <tr>
+ <td>
+ BOOKMARK
+ </td>
<td>
- Show options panel
+ M-b
</td>
- </tr>
- <tr>
<td>
- C-k
+ v, M-b
</td>
<td>
- Show cookie jar
+ View bookmarks
</td>
</tr>
<tr>
+ <td>
+ ADD_BOOKMARK
+ </td>
<td>
- C-c
- </td>
- <td>
- Interrupt
+ M-a
</td>
- </tr>
- <tr>
<td>
- C-z
+ a, M-a
</td>
<td>
- Suspend w3m
+ Add current page to bookmarks
</td>
</tr>
- <tr>
+<!-- </table>-->
+ <tr>
+ <td colspan="4">
+ <h3>File/Stream Operations</h3>
+ </td>
+ </tr>
+<!-- <table>-->
+ <tr>
+ <td>
+ GOTO
+ </td>
<td>
- q
+ U
</td>
<td>
- Quit (with confirmation dialog)
- </td>
- </tr>
- <tr>
- <td>
- Q
+ g, U
</td>
<td>
- Quit without confirmation
+ Open specified document in a new buffer
</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>
+<tr>
+<td>GOTO_RELATIVE</td>
+<td>M-u</td>
+<td>M-u</td>
+<td>Open relative address in a new buffer</td>
+</tr>
+ <tr>
+ <td>
+ LOAD
+ </td>
<td>
- Select previous item
+ V
</td>
- </tr>
- <tr>
<td>
- j, C-n, DOWN
+ V
</td>
<td>
- Select next item
+ Open local file in a new buffer
</td>
</tr>
- <tr>
- <td>
- D
- </td>
+ <tr>
+ <td>
+ READ_SHELL
+ </td>
<td>
- Delete current item
+ @
</td>
- </tr>
- <tr>
<td>
- SPC, RET
+ @
</td>
<td>
- Go to the selected item
+ <!--Execute shell command and view output-->
+ <!--mh 2016-06-13 No difference to PIPE_SHELL could be discerned-->
+ Execute shell command and display output in a new buffer
</td>
</tr>
- </table>
- <h3>
- Line-editing mode
- </h3>
- <table>
- <tr>
- <td width="100">
- C-f, RIGHT
- </td>
+ <tr>
+ <td>
+ PIPE_SHELL
+ </td>
<td>
- Move cursor forward
+ #
</td>
- </tr>
- <tr>
<td>
- C-b, LEFT
+ #
</td>
<td>
- Move cursor backward
+ <!--Execute shell command and browse output-->
+ <!--mh 2016-06-13 No difference to READ_SHELL could be discerned-->
+ Execute shell command and display output in a new buffer
</td>
</tr>
- <tr>
+<!-- </table>-->
+ <tr>
+ <td colspan="4">
+ <h3>Content Operations</h3>
+ </td>
+ </tr>
+<!-- <table>-->
+ <tr>
+ <td>
+ VIEW <!-- is an alias to SOURCE -->
+ </td>
<td>
- C-h, BKSPC
+ v
</td>
<td>
- Delete previous character
+ \
</td>
- </tr>
- <tr>
<td>
- C-d
+ Toggle between source code and rendered view of the document
</td>
+ </tr>
+<tr>
+<td>LIST</td>
+<td>L</td>
+<td>L</td>
+<td>List link elements, hyperlinks and images</td>
+</tr>
+ <tr>
+ <td>
+ FRAME
+ </td>
<td>
- Delete current character
+ F
</td>
- </tr>
- <tr>
<td>
- C-k
+ F
</td>
<td>
- Kill everything after cursor
+ Toggle rendering HTML frames
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ REDRAW
+ </td>
<td>
- C-u
+ C-l
</td>
<td>
- Kill everything before cursor
+ C-l, C-w
</td>
- </tr>
- <tr>
<td>
- C-a
+ Draw the screen anew
</td>
+ </tr>
+ <tr>
+ <td>
+ RELOAD
+ </td>
<td>
- Move to the beginning of line
+ R
</td>
- </tr>
- <tr>
<td>
- C-e
+ R, C-r
</td>
<td>
- Move to the end of line
+ Load current document anew
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ EDIT
+ </td>
<td>
- C-p, UP
+ E
</td>
<td>
- Fetch the previous string from the history list
+ E
</td>
- </tr>
- <tr>
<td>
- C-n, DOWN
+ Edit local source
</td>
+ </tr>
+ <tr>
+ <td>
+ EDIT_SCREEN
+ </td>
<td>
- Fetch the next string from the history list
+ M-e
</td>
- </tr>
- <tr>
<td>
- TAB, SPC
+ M-e
</td>
<td>
- Try to complete filename
+ Edit rendered copy of document
</td>
</tr>
- <tr>
+<tr>
+<td>PIPE_BUF</td>
+<td>|</td>
+<td>|</td>
+<td>Pipe current buffer through a shell command and display output</td>
+</tr>
+ <tr>
+ <td>
+ DOWNLOAD <!-- is an alias to SAVE -->
+ </td>
<td>
- RET
+ M-s
</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, +
+ M-s
</td>
<td>
- Forward page
+ Save document source
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ SAVE_SCREEN
+ </td>
<td>
- b, M-v, -
+ S
</td>
<td>
- Backward page
- </td>
- </tr>
- <tr>
- <td>
- l
+ S, p
</td>
<td>
- Cursor right
+ Save rendered document
</td>
</tr>
- <tr>
+<!-- </table>-->
+ <tr>
+ <td colspan="4">
+ <h3>Buffer/Tab Navigation</h3>
+ </td>
+ </tr>
+<!-- <table>-->
+ <tr>
+ <td>
+ BACK
+ </td>
<td>
- h
+ B
+ </td>
+ <td>
+ B, C-b, LEFT
</td>
<td>
- Cursor left
+ Close current buffer and return to the one below in stack
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ SELECT_MENU
+ </td>
<td>
- j
+ s
</td>
<td>
- Cursor down
+ s, C-h
</td>
- </tr>
- <tr>
<td>
- k
+ Pop up buffer-stack menu
</td>
+ </tr>
+ <tr>
+ <td>
+ TAB_MENU
+ </td>
<td>
- Cursor up
+ M-t
</td>
- </tr>
- <tr>
<td>
- J
+ M-t
</td>
<td>
- Scroll screen up one line
+ Pop up tab selection menu
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ NEW_TAB
+ </td>
<td>
- K
+ T
</td>
<td>
- Scroll screen down one line
+ T
</td>
- </tr>
- <tr>
<td>
- ^
+ Open a new tab (with current document)
</td>
+ </tr>
+ <tr>
+ <td>
+ TAB_LINK
+ </td>
<td>
- Go to the beginning of line
+ C-t
</td>
- </tr>
- <tr>
<td>
- $
+ C-t
</td>
<td>
- Go to the end of line
+ Follow current hyperlink in a new tab
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ NEXT_TAB
+ </td>
<td>
- &gt;
+ }
</td>
<td>
- Shift screen right
+ }
</td>
- </tr>
- <tr>
<td>
- &lt;
+ Switch to the next tab
</td>
+ </tr>
+ <tr>
+ <td>
+ PREV_TAB
+ </td>
<td>
- Shift screen left
+ {
</td>
- </tr>
- <tr>
<td>
- .
+ {
</td>
<td>
- Shift screen one column right
+ Switch to the previous tab
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ CLOSE_TAB
+ </td>
<td>
- ,
+ C-q
</td>
<td>
- Shift screen one column left
+ C-q
</td>
- </tr>
- <tr>
<td>
- C-a, M-&lt;
+ Close the current tab
</td>
+ </tr>
+<!-- </table>-->
+ <tr>
+ <td colspan="4">
+ <h3>Searches</h3>
+ </td>
+ </tr>
+<!-- <table>-->
+ <tr>
+ <td>
+ SEARCH
+ </td>
<td>
- Go to the first line
+ /
</td>
- </tr>
- <tr>
<td>
- C-e, M-&gt;
+ /, C-s
</td>
<td>
- Go to the last line
+ Search forward
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ SEARCH_BACK
+ </td>
<td>
- G
+ ?
</td>
+ <td>
+ </td>
<td>
- Go to the specified line
+ Search backward
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ ISEARCH
+ </td>
<td>
- w
+ C-s
</td>
+ <td>
+ </td>
<td>
- Go to the next word
+ Incremental search forward
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ ISEARCH_BACK
+ </td>
<td>
- W
+ C-r
</td>
+ <td>
+ </td>
<td>
- Go to the previous word
+ Incremental search backward
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ SEARCH_NEXT
+ </td>
<td>
- Z
+ n
</td>
<td>
- Center on cursor line
- </td>
- </tr>
- <tr>
- <td>
- z
+ n
</td>
<td>
- Center on cursor column
+ Continue search forward
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ SEARCH_PREV
+ </td>
<td>
- TAB, C-n, DOWN
+ N
</td>
+ <td>
+ </td>
<td>
- Move to the next hyperlink
+ Continue search backward
</td>
</tr>
- <tr>
- <td>
- M-TAB, C-p, C-u, UP
- </td>
+ <tr>
+ <td>
+ WRAP_TOGGLE
+ </td>
<td>
- Move to the previous link
+ C-w
</td>
- </tr>
- <tr>
<td>
- C-g
+ w
</td>
<td>
- Show current position in page
+ Toggle wrapping mode in searches
</td>
</tr>
- <tr>
- <td>
- [
- </td>
+<!-- </table>-->
+ <tr>
+ <td colspan="4">
+ <h3>Mark Management</h3>
+ </td>
+ </tr>
+<!-- <table>-->
+ <tr>
+ <td>
+ MARK
+ </td>
<td>
- Move to the first hyperlink
+ C-SPC
</td>
- </tr>
- <tr>
<td>
- ]
+ C-SPC
</td>
<td>
- Move to the last hyperlink
+ Set/unset mark
</td>
</tr>
- </table>
- <h3>
- Hyperlink operation
- </h3>
- <table>
- <tr>
- <td width="100">
- C-f, C-j, C-m, RET, RIGHT
- </td>
+ <tr>
+ <td>
+ PREV_MARK
+ </td>
<td>
- Follow hyperlink
+ M-p
</td>
- </tr>
- <tr>
<td>
- d, M-RET
+ P
</td>
<td>
- Save link to file
+ Go to the previous mark
</td>
</tr>
- <tr>
- <td>
- u
- </td>
+ <tr>
+ <td>
+ NEXT_MARK
+ </td>
<td>
- Show link URL
+ M-n
</td>
- </tr>
- <tr>
<td>
- i
+ N
</td>
<td>
- Show image URL
+ Go to the next mark
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ REG_MARK
+ </td>
<td>
- I
+ "
</td>
<td>
- View inline image
- </td>
- </tr>
- <tr>
- <td>
- M-I
+ "
</td>
<td>
- Save inline image to file
+ Mark all occurrences of a pattern
</td>
</tr>
- <tr>
+<!-- </table>-->
+ <tr>
+ <td colspan="4">
+ <h3>Miscellaneous</h3>
+ </td>
+ </tr>
+<!-- <table>-->
+ <tr>
+ <td>
+ COMMAND
+ </td>
<td>
- :
+ M-c
</td>
<td>
- Mark URL-like strings as hyperlinks
+ M-c
</td>
- </tr>
- <tr>
<td>
- M-:
+ Invoke one or more semicolon-separated w3m functions
</td>
+ </tr>
+<!--
+TODO: Where does this key binding M-Fn come from. I do not find a Fn-key on my keyboard. I do not know how to type in the keystroke combinations listed in keymap.default which are
+keymap M-[E MENU
+keymap M-[L MENU
+keymap M-[2~ MENU
+keymap M-[28~ MENU
+<tr>
+<td>MENU</td>
+<Td>M-Fn</Td>
+<td></td>
+<td>Pop up menu</td>
+</tr>
+-->
+ <tr>
+ <td>
+ HELP
+ </td>
<td>
- Mark Message-ID-like strings as news anchors
+ H
</td>
- </tr>
- <tr>
<td>
- c
+ H, ?
</td>
<td>
- Show current URL
+ Show help panel
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ OPTIONS
+ </td>
<td>
- =
+ o
</td>
<td>
- Show information about current document
+ o
</td>
- </tr>
- <tr>
<td>
- C-h
- </td>
+ Display options setting panel
+ </td>
+ </tr>
+<tr>
+<td>SET_OPTION</td>
+<td>M-o</td>
+<td>M-o</td>
+<td>Set option</td>
+</tr>
+<tr>
+<td>DEFINE_KEY</td>
+<td>M-k</td>
+<td>M-k</td>
+<td>Define a binding between a key stroke combination and a command</td>
+</tr>
+<tr>
+<td>MOUSE_TOGGLE</td>
+<td>m</td>
+<td>m</td>
+<td>Toggle mouse support</td>
+</tr>
+<tr>
+<td>DOWNLOAD_LIST</td>
+<td>D</td>
+<td>D</td>
+<td>Display downloads panel</td>
+</tr>
+ <tr>
+ <td>
+ COOKIE
+ </td>
<td>
- Show browsing history
+ C-k
</td>
- </tr>
- <tr>
<td>
- M
+ C-k
</td>
<td>
- Browse current document using external browser (prefix 2, 3, ...,
- or 9 to invoke alternate configured browsers, e.g. 3 M)
+ Show cookie jar
</td>
</tr>
+<!--
+mh 2016-06-12 Interrupt is an alias to SUSPEND, no need to mention it here
<tr>
+ <td>
+ INTERRUPT
+ </td>
<td>
- M-M
+ C-c
</td>
<td>
- Browse link using external browser (prefixed as above, e.g.
- 3 M-M)
- </td>
- </tr>
- </table>
- <h3>
- Bookmark management
- </h3>
- <table>
- <tr>
- <td width="100">
- v, M-b
+ C-c
</td>
<td>
- Go to the bookmarks page
+ Interrupt
</td>
</tr>
- <tr>
+-->
+<tr>
+<td>UNDO</td>
+<td>(</td>
+<td>(</td>
+<td>Cancel the last cursor movement</td>
+</tr>
+<tr>
+<td>REDO</td>
+<td>)</td>
+<td>)</td>
+<td>Cancel the last undo</td>
+</tr>
+ <tr>
+ <td>
+ EXEC_SHELL <!-- is an alias of SHELL -->
+ </td>
<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
+ Execute shell command
</td>
</tr>
- <tr>
- <td>
- V
- </td>
+<tr>
+<td>DICT_WORD</td>
+<td>M-w</td>
+<td>M-w</td>
+<td>Execute dictionary command (see <a href="README.dict">README.dict</a>)</td>
+</tr>
+<tr>
+<td>DICT_WORD_AT</td>
+<td>M-W</td>
+<td>M-W</td>
+<td>Execute dictionary command for word at cursor</td>
+</tr>
+<tr>
+<td>VERSION</td>
+<td>r</td>
+<td>r</td>
+<td>Display the version of w3m</td>
+</tr>
+ <tr>
+ <td>
+ SUSPEND
+ </td>
<td>
- Open new file
+ C-z
</td>
- </tr>
- <tr>
<td>
- @
+ C-z
</td>
<td>
- Execute shell command and view output
+ Suspend w3m to background. (To be withdrawn with shell
+ command <span class="mono">fg</span>.)
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ QUIT
+ </td>
<td>
- #
+ q
</td>
<td>
- Execute shell command and browse output
- </td>
- </tr>
- </table>
- <h3>
- Content operations
- </h3>
- <table>
- <tr>
- <td width="100">
- \
+ q
</td>
<td>
- Toggle viewing as text or rendered HTML
+ Quit with confirmation request
</td>
</tr>
- <tr>
- <td>
- F
- </td>
+ <tr>
+ <td>
+ EXIT
+ </td>
<td>
- Toggle rendering HTML frames
+ Q
</td>
- </tr>
- <tr>
<td>
- C-l, C-w
+ Q
</td>
<td>
- Redraw screen
+ Quit at once
</td>
</tr>
- <tr>
+ </table>
+
+ <p>
+ There are the following operational modes with built-in key
+ bindings for relevant functions. These bindings are not subject to
+ the DEFINE_KEY function or entries in the file keymap.
+ </p>
+
+ <table border="1" width="100%">
+ <colgroup>
+ <col width="20%">
+ <col width="40%">
+ <col width="40%">
+ </colgroup>
+ <tr>
+ <th>
+ Function<br>(internal name)
+ </th>
+ <th>Key binding
+ </th>
+ <th>
+ Description
+ </th>
+ </tr>
+ <tr>
+ <td colspan="3">
+ <h3>Menu Selection Mode</h3>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ BUF:NEXT</td>
<td>
- R, C-r
+ j, C-n, DOWN
</td>
<td>
- Reload
+ Next item
</td>
</tr>
- <tr>
+ <tr>
+ <td>BUF:PREV
+ </td>
<td>
- E
+ k, C-p, UP
</td>
<td>
- Edit local source
+ Previous item
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ BUF:DELETE</td>
<td>
- M-e
+ D
</td>
<td>
- Edit rendered copy of page
+ Delete item
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+ BUF:GO
+ </td>
<td>
- M-s
+ SPC, RET, RIGHT
</td>
<td>
- Save source
+ Select item
</td>
</tr>
- <tr>
+<!-- </table>-->
+ <tr>
+ <td colspan="3">
+ <h3>Popup Menu Mode</h3>
+ </td>
+ </tr>
+<!-- <table>-->
+ <tr>
+ <td>
+MENU:SELECT
+ </td>
<td>
- S, p
- </td>
+ SPC, RET, RIGHT</td>
<td>
- Save rendered copy of page
+ Select
</td>
</tr>
- </table>
- <h3>
- Buffer/tab navigation
- </h3>
- <table>
- <tr>
- <td width="100">
- B, C-b, LEFT
+ <tr>
+ <td>
+MENU:CLOSE
+ </td>
+ <td>C-c
</td>
<td>
- Go back, <q>popping</q> the buffer stack
+ Close menu
</td>
</tr>
- <tr>
- <td>
- s, C-h
- </td>
+ <tr>
+ <td>
+MENU:CANCEL
+ </td>
+ <td>
+ LEFT, BKSPC, C-h</td>
<td>
- Show buffer-stack menu
+ One selection step backward
</td>
</tr>
- <tr>
- <td>
- M-t
+ <tr>
+ <td>
+MENU:DOWN
+ </td>
+ <td>j, C-n, DOWN
</td>
<td>
- Show tab menu
+ Move to the next item
</td>
</tr>
- <tr>
- <td>
- T
- </td>
+ <tr>
+ <td>
+MENU:UP
+ </td>
+ <td>
+ k, C-p, UP</td>
<td>
- Open current page as new tab
+ Move to the previous item
</td>
</tr>
- <tr>
- <td>
- C-t
+ <tr>
+ <td>
+MENU:LINE_UP
+ </td>
+ <td>K
</td>
<td>
- Open link as new tab
+ Scroll up one item
</td>
</tr>
- <tr>
- <td>
- }
+ <tr>
+ <td>
+MENU:LINE_DOWN
+ </td>
+ <td>J
</td>
<td>
- Switch to next tab
+ Scroll down one item
</td>
</tr>
- <tr>
- <td>
- {
+ <tr>
+ <td>
+MENU:TOP
+ </td>
+ <td>C-a
</td>
<td>
- Switch to previous tab
+ Move to the first item
</td>
</tr>
- <tr>
- <td>
- C-q
+ <tr>
+ <td>
+MENU:LAST
+ </td>
+ <td>C-e
</td>
<td>
- Close current tab
+ Move to the final item
</td>
</tr>
- </table>
- <h3>
- Search
- </h3>
- <table>
- <tr>
- <td width="100">
- /, C-s
+ <tr>
+ <td>
+MENU:NEXT
+ </td>
+ <td>C-v, C-f
</td>
- <td>
- Search forward
+ <td>Go to the next page
</td>
</tr>
- <tr>
- <td>
- n
+ <tr>
+ <td>
+MENU:PREV
+ </td>
+ <td>ESC v, C-b
</td>
<td>
- Next match
+ Go to the previous page
</td>
</tr>
- <tr>
- <td>
- w
+ <tr>
+ <td>
+MENU:SEARCH_FORE
+ </td>
+ <td>C-s, /
</td>
<td>
- Toggle wrapping mode in searches
+ Search forward
</td>
</tr>
- </table>
- <h3>
- Mark management
- </h3>
- <table>
- <tr>
+ <tr>
+ <td>
+MENU:SEARCH_BACK
+ </td>
+ <td>
+ C-r, ?</td>
+ <td>
+ Search backward
+ </td>
+ </tr>
+ <tr>
+ <td>
+MENU:SEARCH_NEXT
+ </td>
+ <td>
+ n</td>
+ <td>
+ Search for the next match</td>
+ </tr>
+ <tr>
+ <td>
+MENU:SEARCH_PREV
+ </td>
+ <td>
+ N</td>
+ <td>
+ Search for the previous match</td>
+ </tr>
+<!--mh 2016-06-12 Pressing C-z in menu mode (with menu active) has the same effect as in normal operation of w3m: Browser gets in the background
+ <tr>
+ <td>
+MENU:SUSPEND
+ </td>
+ <td>
+ C-z</td>
+ <td>
+ Suspend</td>
+ </tr>
+-->
+<!-- </table>-->
+ <tr>
+ <td colspan="3">
+ <h3>Line-editing Mode</h3>
+ </td>
+ </tr>
+<!-- <table>-->
+ <tr>
+ <td>
+ LINEEDIT:FORWARD
+ </td>
<td width="100">
- C-SPC
+ C-f, RIGHT
</td>
<td>
- Set/unset mark
+ Move cursor forward
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+LINEEDIT:BACK
+ </td>
<td>
- P
+ C-b, LEFT
</td>
<td>
- Go to the previous mark
+ Move cursor backward
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+LINEEDIT:BS
+ </td>
<td>
- N
+ C-h, BKSPC
</td>
<td>
- Go to the next mark
+ Delete previous character
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+LINEEDIT:DEL
+ </td>
<td>
- "
+ C-d
</td>
<td>
- Mark all occurrences of a regular expression
+ Delete current character
</td>
</tr>
- </table>
- <h3>
- Miscellany
- </h3>
- <table>
- <tr>
- <td width="100">
- !
+ <tr>
+ <td>
+LINEEDIT:KILL_AFTER
+ </td>
+ <td>
+ C-k
</td>
<td>
- Execute shell command
+ Delete everything after cursor
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+LINEEDIT:KILL_BEFORE
+ </td>
<td>
- M-c
+ C-u
</td>
<td>
- Invoke w3m function
+ Delete everything before cursor
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+LINEEDIT:TOP
+ </td>
<td>
- H, ?
+ C-a
</td>
<td>
- Show help panel
+ Move to the beginning of the line
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+LINEEDIT:BOTTOM
+ </td>
<td>
- o
+ C-e
</td>
<td>
- Show options panel
+ Move to the end of the line
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+LINEEDIT:PREV
+ </td>
<td>
- C-k
+ C-p, UP
</td>
<td>
- Show cookie jar
+ Fetch the previous string from the history list
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+LINEEDIT:NEXT
+ </td>
<td>
- C-c
+ C-n, DOWN
</td>
<td>
- Interrupt
+ Fetch the next string from the history list
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+LINEEDIT:COMPLETE
+ </td>
<td>
- C-z
+ TAB, SPC
</td>
<td>
- Suspend w3m
+ Try to complete filename
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+LINEEDIT:EDITOR
+ </td>
<td>
- q
+ C-o
</td>
<td>
- Quit (with confirmation dialog)
+ Edit with external editor
</td>
</tr>
- <tr>
+ <tr>
+ <td>
+LINEEDIT:ACCEPT
+ </td>
<td>
- Q
+ RET
</td>
<td>
- Quit without confirmation
+ Accept input line
</td>
</tr>
</table>
- <p>
+<!-- mh 2016-06-12 As it suffices to use the provided keymap file for Lynx-like keybindings and this file is listed in section FILES of man w3m (1), the following hint for getting w3m with Lynx-like key bindings has been deleted.
+ <p>
+ If w3m was compiled with <q>Lynx-like key bindings</q>, you can use
+ the following key bindings.
+ </p>
+-->
+<!-- mh 2016-06-12 Remark is obsolete as the two sets key binding are presented along within tables
+ <hr>
+ <h2 id="Key:lynx">
+ <p>
The Lynx-like configuration leaves keymappings unchanged in the
menu-selection and line-editing modes.
</p>
+ </h2>
+-->
<hr>
<h2 id="Mouse">
- Mouse operation
+ Mouse Operation
</h2>
<p>
If w3m is compiled with mouse support and you are invoking w3m
@@ -2092,15 +2287,29 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p
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>
+ <p>An introduction to configure mouse actions is provided
+ with <a href="README.mouse">README.mouse</a>.
+ </p>
+ <table border="1">
+ <colgroup>
+ <col width="20%">
+ <col width="80%">
+ </colgroup>
+ <tr>
+ <th>Operation
+ </th>
+ <th>Description
+ </th>
+ </tr>
+ <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.
+<b>First:</b><br>
+Moves the cursor to the place indicated by the mouse pointer.<br>
+<b>Then:</b><br>
+Follows a hyperlink the cursor is currently located and the mouse points to.
</td>
</tr>
<tr>
@@ -2126,33 +2335,13 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p
<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.
+ drag it) with the options 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>
- <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
+ Local CGI scripts
</h2>
<p>
You can run CGI scripts using w3m, without any HTTP server.
@@ -2174,28 +2363,27 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p
</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
+ like in the options 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:
+ <q>:</q>, like /usr/local/cgi-bin:/home/aito/cgi-bin. It is not
+ recommended to include the current directory to this path. To use
+ a /cgi-bin/ directory, you must use a file:/cgi-bin URL as follows:
+ </li>
<pre>
w3m -o cgi_bin=/path/to/cgi-bin file:/cgi-bin/script.cgi
</pre>
- 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
+ The CGI script can use the special header
+ <span class="mono">w3m-control:</span> 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>
<p>
will display a blank page and delete that buffer immediately.
@@ -2203,34 +2391,30 @@ W3m-control: BACK
the script is invoked. The next example
</p>
<pre>
-
Content-Type: text/plain
W3m-control: DELETE_PREVBUF
-
contents.....
</pre>
<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.
+ Each header <span class="mono">w3m-control:</span> can
+ contain only one function, but you can
+ include more than one <span class="mono">w3m-control:</span>
+ 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.example.org/
-
</pre>
<p>
This example works exactly the same way as the Location header:
</p>
<pre>
-
Content-Type: text/plain
Location: http://www.example.org/
-
</pre>
<p>
Note that this header has no effect when the CGI script is invoked
generated by cgit v1.2.3 (git 2.25.1) at 2024-11-22 20:34:48 +0000