diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/MANUAL.html | 2354 |
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[&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[&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> - </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> - > + K </td> <td> - Shift screen right + Scroll the screen down one line </td> </tr> <tr> + <td> + LINE_BEGIN + </td> <td> - < - </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-<, 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->, 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> - > + } </td> <td> - Shift screen right + } </td> - </tr> - <tr> <td> - < + 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-< + 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-> + /, 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 |