From 45d40611a8d35ba395e5082688a783dfa886b588 Mon Sep 17 00:00:00 2001 From: Markus Hiereth Date: Mon, 8 Aug 2016 20:23:56 +0900 Subject: Update MANUAL.html in English and German Origin: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=772341#90 --- doc/MANUAL.html | 2438 ++++++++++++++++++++++++++++++------------------------- 1 file changed, 1311 insertions(+), 1127 deletions(-) (limited to 'doc') 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 @@ - - - - w3m manual - - - + + w3m manual + + + + - - +insertions tagged with "mh 2016-03-29" and "mh 2016-06-11" come from the latest version of manual page w3m (1) + --> +

w3m MANUAL

Akinori Ito
@@ -37,32 +33,36 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa
  • - Document colors + Document Colors
  • - - Key bindings + + Functions and Key bindings
    • +
  • - Mouse operation + Mouse Operation
    • +
  • - Local CGI + Local CGI scripts
    • @@ -81,8 +81,9 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa

    Command line usage is

    + 
    -    w3m [options] [file|URL]
+  w3m [option]... [file|URL]...

    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:

    -
    - +number +

    General options

    +
    + -B

    - Move to the specified line-number. + + with no other target defined, use the bookmark page for startup

    -
    - -t width - +
    + -M

    - Specify tab width. Default is 8. - + + monochrome display

    - -r + -no-mouse

    - When displaying text/plain documents, prohibit emphasis using - backspace. If you don't specify this option, A^H_ is - interpreted as an underlined A and A^HA as a bold - A. - + deactivate mouse support.

    - -l number + -num

    - Specify the number of lines that should be cached while reading a - text/plain document from standard input. Default is 10,000. + + display each line's number +

    + + 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)

    +-->
    - -I charset + -v

    - Specify document charset. - + + with no other target defined, welcome users with a built-in page

    - -T type + -W

    - 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: -

    -

    - Read HTML document from standard input and display it + + toggle wrapping mode in searches

    -
    -   cat example.html | w3m -T text/html
-
    -

    - Display HTML source -

    -
    -   w3m -T text/plain example.html
-
    - -m + -X

    - Display document using Internet message mode. With this - option, w3m determines document type from header information. - This is useful when reading e-mail or Usenet news posts. - + upon exit, do not reinitialize the terminal.

    - -v + +num
    -

    - Show w3m's startup page. - +

    + go to line num; only effective for numbers larger + than the number of lines in the terminal

    +

    Browser options

    - -B + -cols num

    - Show w3m's bookmarks page. - + + with stdout as destination; HTML is rendered to lines of num + characters

    - -bookmark file + -cookie

    - Specify a custom bookmarks file. + + use stored cookies and accept new ones

    - -M + -no-cookie

    - Monochrome display mode. - + + neither use stored cookies nor accept new ones +

    @@ -238,250 +214,238 @@ monochrome display

    - Automatically render HTML frames. - + + render frames

    - -s + -no-graph

    - Squeeze blank lines. - + + do not use graphic characters for drawing HTML table and frame + borders

    - -X + -header string

    - Upon exit, do not reinitialize the terminal. + + append string to the HTTP(S) request. Expected to match + the header syntax "Variable: Value"

    - -W + -m

    - Toggle wrapping mode in searches. + display document using Internet message mode. With this + option, w3m determines document type from header information. + This is useful when reading e-mail or Usenet news posts. -

    - -o option=value + -no-proxy

    - Specify option. The available option names and values are the - same as in ~/.w3m/config. - -

    + + do not use proxy +

    - -cookie + -post file
    -

    - Process cookies. - - +

    + use POST method to upload data defined in file. The + syntax to be used is "var1=value1[&var2=value2]…"

    +

    Text pager options

    - -no-cookie + -l num

    - Don't process cookies. - - + + number of lines preserved internally when receiving plain text + from stdin (default 10,000)

    - -num + -r

    - Show line-numbers. - + + 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

    - -dump + -s

    - 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. - - - + + squeeze multiple blank lines into one

    -
    - -cols width + +
    + -t num

    - Specify document width. Used with -dump option. + set tab width to num columns. No effect on stdout

    +

    Data type/encoding options

    - -ppc count + -I charset

    - Specify the number of pixels per character (default 8.0). Larger - values will make tables narrower. - + + user defined character encoding of input data

    - -dump_source + -O charset

    - Read document specified by URL and dump the source. - + + user defined character encoding of output data

    - -dump_head + -T type
    +

    + + 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: +

    - Read document specified by URL and dump headers. - + Read HTML document from standard input and display it

    +
    +   cat example.html | w3m -T text/html
+
    +

    + Display HTML source +

    +
    +   w3m -T text/plain example.html
+
    +

    Options for data output, followed by immediate exit

    - -dump_both + -dump
    -

    - Read document specified by URL and dump headers and the source. - - -

    +

    + read document specified by URL and dump page rendered as text + into standard output. + + 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. +

    - -dump_extra + -dump_source

    - Read document specified by URL and dump extra informations, - headers, and the source. - - + + dump the page's source code into stdout

    - -post file + -dump_head

    - Use POST method with file content. - - + + dump response of a HEAD request for a URL into stdout

    - -header string + -dump_both

    - Insert string as a header. - + + dump HEAD, and source code for a URL into stdout

    - -no-proxy + -dump_extra

    - Don't use proxy server. + + dump HEAD, source code, and extra information for a URL into + stdout

    + +

    Options for overriding default settings and resources

    +
    - -no-graph + -bookmark file

    - Use ASCII characters to draw frames rather than graphical ones. - - + + use file instead of the default bookmark.html file

    - -no-mouse + -config file

    - Deactivate mouse support. + + use file instead of the default configuration file

    - -config file + -o option=value

    - Specify config file. + + modify one configuration item with an explicitly given value; without option=value, equivalent to -show-option

    - Document colors + Document Colors

    - Links and images are displayed as follows. + Hyperlinks and images are displayed as follows.

    -   Color mode @@ -492,7 +456,7 @@ frame borders
    - links + Hyperlinks blue @@ -503,7 +467,7 @@ frame borders
    - inline images + Inline images green @@ -514,7 +478,7 @@ frame borders
    - form input + Form input red @@ -526,157 +490,302 @@ frame borders

    - These colors can be customized using the option setting command - o. + These colors can be customized using the options setting command + o.

    -

    - Key bindings +

    + Functions and Key bindings

    + +

    + 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. + +

    +

    + Key customization +

    +-->

    - 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,

    + +
    +   keymap C-o NEXT_PAGE
+
    +

    - Here's the original key-binding table. If you are using Lynx-like - key bindings, see the Lynx-like key - bindings. Throughout, the C- and M- notations - indicate the modifiers control and meta (which can be - replaced with alt or ESC); on the other hand 2 M - simply means 2 followed by M. + binds the command NEXT_PAGE (normally bound to SPC and C-v) + to control-o. See README.func for a list + of available functions. Original and Lynx-like keymap definitions + are provided as examples: keymap.default + and keymap.lynx.

    - -

    - In-page navigation -

    - - -
    + +

    + Throughout, the C- and M- notations indicate the + modifiers control and meta. The ALT-key + replaces the latter whereas pressing the ESC-key toggles + between meta-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. 2 M + simply means 2 followed by M. +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -685,62 +794,130 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p + + + + + + + + + + + + + + + + + + + + + + + + @@ -749,6 +926,12 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p + + @@ -756,98 +939,180 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p Move to the last hyperlink -
    + Function + Key binding + + Description +
    + Default + + Lynx-like +
    +

    In-page navigation

    +
    + NEXT_PAGE + SPC, C-v, +, PGDN - Forward page + SPC, C-v, + + + Scroll one page downwards
    + PREVIOUS_PAGE + b, M-v, -, PGUP - Backward page + b, M-v, - + + Scroll one page upwards
    + MOVE_RIGHT + l, C-f, RIGHT - Cursor right + l + + Move cursor right (with a half-screen shift at the screen edge)
    + MOVE_LEFT + h, C-b, LEFT - Cursor left + h + + Move cursor left (with a half-screen shift at the screen edge)
    + MOVE_DOWN + j, C-n, DOWN - Cursor down + j + + Move cursor down (with a one-line scroll at the screen edge)
    + MOVE_UP + k, C-p, UP - Cursor up + k + + Move cursor up (with a one-line scroll at the screen edge)
    + UP + J - Scroll screen up one line + J + + Scroll the screen up one line
    + DOWN + + K + K - Scroll screen down one line + Scroll the screen down one line
    + LINE_BEGIN + ^, C-a - Go to the beginning of line + ^ + + Go to the beginning of the line
    + LINE_END + $, C-e - Go to the end of line + $ + + Go to the end of the line
    + NEXT_WORD + w - Go to the next word + w + + Move to the next word
    + PREVIOUS_WORD + + W + W - Go to the previous word + Move to the previous word
    + SHIFT_RIGHT + + > + - > + > Shift screen right
    + SHIFT_LEFT + + < + - < + < Shift screen left
    + RIGHT + . - Shift screen one column right + . + + Shift screen one column right
    + LEFT + + , + ,
    + BEGIN + + g, M-<, HOME + - g, M-<, HOME + C-a, M-< Go to the first line
    + END + + G, M->, END + - G, M->, END + C-e, M-> Go to the last line
    + GOTO_LINE + M-g + G + Go to the specified line
    + LINE_INFO + + C-g + + C-g + + Display current position in document +
    + CENTER_H + + Z + Z - Center on cursor column + Center screen right and left of the cursor column
    + CENTER_V + + z + z - Center on cursor line + Center screen above and below the cursor line
    + NEXT_LINK + TAB + TAB, C-n, DOWN + Move to the next hyperlink
    + PREVIOUS_LINK + + M-TAB, C-u + - C-u, M-TAB + M-TAB, C-u, C-p, UP Move to the previous hyperlink
    + LINK_BEGIN + + [ + [
    + LINK_END + + ] + ]
    -

    Hyperlink operation

    - + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - + + @@ -856,6 +1121,12 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p + + @@ -865,6 +1136,12 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p + + @@ -873,78 +1150,148 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p 3 M-M) -
    MOVE_LIST_MENUM-mM-mPop up menu to navigate between hyperlinks
    +

    Hyperlink Operations

    +
    + + GOTO_LINK + C-j, C-m, RET + C-f, C-j, C-m, RET, RIGHT + - Follow hyperlink + Follow current hyperlink in a new buffer
    LIST_MENUM-lM-lPop up hyperlink menu and select one to be followed
    + SAVE_LINK + a, M-RET - Save link to file + d, M-RET + + Save the hyperlink target
    + PEEK_LINK + u - Show link URL + u + + Show target address
    + PEEK_IMG + + i + i - Show image URL + Show image address
    + VIEW_IMAGE + + I + I - View inline image + Display image in viewer
    + SAVE_IMAGE + + M-I + M-I - Save inline image to file + Save inline image
    MARK_WORD;;Turn current word into hyperlink
    + MARK_URL + : - Mark URL-like strings as hyperlinks + : + + Turn URL-like strings into hyperlinks
    + MARK_MID + + M-: + M-: - Mark Message-ID-like strings as links + + Turn Message-ID-like strings into hyperlinks
    + PEEK + + c + c - Show current URL + Show current address
    + INFO + = - Show information about current document -
    - C-g + = - Show current position in page + Display information about the current document
    + HISTORY + + C-h + C-h
    + EXTERN + + M + M
    + EXTERN_LINK + + M-M + M-M
    -

    - Bookmark management -

    - - - + + + + + + + + + -
    + +
    +

    Bookmark management

    +
    + BOOKMARK + M-b - Go to the bookmarks page + v, M-b + + View bookmarks
    + ADD_BOOKMARK + M-a - Bookmark current page + a, M-a + + Add current page to bookmarks
    -

    - File/stream operation -

    - - - + + + + + + + - + + + + + + + + + - + + + - + + + -
    + +
    +

    File/Stream Operations

    +
    + GOTO + U - Open new URL + g, U + + Open specified document in a new buffer
    GOTO_RELATIVEM-uM-uOpen relative address in a new buffer
    + LOAD + + V + V - Open new file + Open local file in a new buffer
    + READ_SHELL + @ - Execute shell command and view output + @ + + + + Execute shell command and display output in a new buffer
    + PIPE_SHELL + + # + # - Execute shell command and browse output + + + Execute shell command and display output in a new buffer
    -

    - Content operations -

    - - - + + + + + + + - + + + + + + + + + @@ -952,23 +1299,41 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p Toggle rendering HTML frames - + + + - + + + - + + + @@ -976,1115 +1341,945 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p Edit local source - + + + - + + + + + + + + + - + + + -
    + +
    +

    Content Operations

    +
    + VIEW + v - Toggle viewing as text or rendered HTML + \ + + Toggle between source code and rendered view of the document
    LISTLLList link elements, hyperlinks and images
    + FRAME + + F + F
    + REDRAW + C-l - Redraw screen + C-l, C-w + + Draw the screen anew
    + RELOAD + R - Reload + R, C-r + + Load current document anew
    + EDIT + + E + E
    + EDIT_SCREEN + + M-e + M-e - Edit rendered copy of page + Edit rendered copy of document
    PIPE_BUF||Pipe current buffer through a shell command and display output
    + DOWNLOAD + + M-s + M-s - Save source + Save document source
    + SAVE_SCREEN + S - Save rendered copy of page + S, p + + Save rendered document
    -

    - Buffer/tab navigation -

    - - - + + + + + + + - + + + - + + + - + + + - + + + - + + + - + + + - + + + -
    + +
    +

    Buffer/Tab Navigation

    +
    + BACK + B + + B, C-b, LEFT - Go back, popping the buffer stack + Close current buffer and return to the one below in stack
    + SELECT_MENU + s - Show buffer-stack menu + s, C-h + + Pop up buffer-stack menu
    + TAB_MENU + + M-t + M-t - Show tab menu + Pop up tab selection menu
    + NEW_TAB + T - Open current page as new tab + T + + Open a new tab (with current document)
    + TAB_LINK + + C-t + C-t - Open link as new tab + Follow current hyperlink in a new tab
    + NEXT_TAB + } - Switch to next tab + } + + Switch to the next tab
    + PREV_TAB + + { + { - Switch to previous tab + Switch to the previous tab
    + CLOSE_TAB + C-q - Close current tab + C-q + + Close the current tab
    -

    - Search -

    - - - + + + + + + + - + + + - - + + + - + + + - + + - - - - - + + - -
    + +
    +

    Searches

    +
    + SEARCH + / + /, C-s + Search forward
    + SEARCH_BACK + ? + Search backward
    +
    + ISEARCH + C-s + Incremental search forward
    + ISEARCH_BACK + C-r + Incremental search backward
    + SEARCH_NEXT + n - Next match -
    - N + n - Previous match + Continue search forward
    - C-w -
    + SEARCH_PREV + - Toggle wrapping mode in searches -
    -

    - Mark management -

    - - - + - - + + - - - + + + + + + + - -
    - C-SPC + N + - Set/unset mark + Continue search backward
    - M-p -
    + WRAP_TOGGLE + - Go to the previous mark + C-w
    - M-n + w - Go to the next mark + Toggle wrapping mode in searches
    +

    Mark Management

    +
    + MARK + - " + C-SPC - Mark all occurrences of a regular expression -
    -

    - Miscellany -

    - - - - - + + - - - - + + - - - - + + - - - - + + + + + + + - - -
    - ! + C-SPC - Execute shell command + Set/unset mark
    - M-c -
    + PREV_MARK + - Invoke w3m function + M-p
    - H + P - Show help panel + Go to the previous mark
    - o -
    + NEXT_MARK + - Show options panel + M-n
    - C-k + N - Show cookie jar + Go to the next mark
    - C-c -
    + REG_MARK + - Interrupt + "
    - C-z + " - Suspend w3m + Mark all occurrences of a pattern
    - q -
    +

    Miscellaneous

    +
    + COMMAND + - Quit (with confirmation dialog) + M-c
    - Q + M-c - Quit without confirmation + Invoke one or more semicolon-separated w3m functions
    -

    - Two special operational modes exist which have built-in (not - redefinable) keymappings: -

    -

    - Menu selection mode -

    - - - - - - - - - - - - - - - - - -
    - k, C-p, UP - - Select previous item -
    - j, C-n, DOWN - - Select next item -
    - D - - Delete current item -
    - SPC, RET - - Go to the selected item -
    -

    - Line-editing mode -

    - - - +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 + + + + + + +--> + + - - - - + + - - - - + Display options setting panel + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - + + + + + + + + + + + + + + + - - - - + + + + + + + + + + + + + + + + + + + + - - -
    - C-f, RIGHT -
    MENUM-FnPop up menu
    + HELP + - Move cursor forward + H
    - C-b, LEFT + H, ? - Move cursor backward + Show help panel
    - C-h, BKSPC -
    + OPTIONS + - Delete previous character + o
    - C-d + o - Delete current character -
    SET_OPTIONM-oM-oSet option
    DEFINE_KEYM-kM-kDefine a binding between a key stroke combination and a command
    MOUSE_TOGGLEmmToggle mouse support
    DOWNLOAD_LISTDDDisplay downloads panel
    + COOKIE + C-k - Kill everything after cursor -
    - C-u - - Kill everything before cursor -
    - C-a + C-k - Move to the beginning of line + Show cookie jar
    UNDO((Cancel the last cursor movement
    REDO))Cancel the last undo
    + EXEC_SHELL + - Open new URL + !
    - V + ! - Open new file + Execute shell command
    - @ -
    DICT_WORDM-wM-wExecute dictionary command (see README.dict)
    DICT_WORD_ATM-WM-WExecute dictionary command for word at cursor
    VERSIONrrDisplay the version of w3m
    + SUSPEND + - Execute shell command and view output + C-z
    - # + C-z - Execute shell command and browse output + Suspend w3m to background. (To be withdrawn with shell + command fg.)
    -

    - Content operations -

    - - - + + - - - + + + - +
    - \ -
    + QUIT + - Toggle viewing as text or rendered HTML + q
    - F + q - Toggle rendering HTML frames + Quit with confirmation request
    + EXIT + - C-l, C-w + Q - Redraw screen + Q + + Quit at once
    + +

    + 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. +

    + + + + + + + + + + + + + + + + + - + + - + + - + + - + + + + + + + + SPC, RET, RIGHT -
    + Function
    (internal name) +     		Key binding + + Description +
    +

    Menu Selection Mode

    +
    + BUF:NEXT - R, C-r + j, C-n, DOWN - Reload + Next item
    BUF:PREV + - E + k, C-p, UP - Edit local source + Previous item
    + BUF:DELETE - M-e + D - Edit rendered copy of page + Delete item
    + BUF:GO + - M-s + SPC, RET, RIGHT - Save source + Select item
    +

    Popup Menu Mode

    +
    +MENU:SELECT + - S, p - - Save rendered copy of page + Select
    -

    - Buffer/tab navigation -

    - - - + + - - + + + - - + + - - + + + - - + + - - + + - - + + - - + + -
    - B, C-b, LEFT +
    +MENU:CLOSE + C-c - Go back, popping the buffer stack + Close menu
    - s, C-h -
    +MENU:CANCEL + + LEFT, BKSPC, C-h - Show buffer-stack menu + One selection step backward
    - M-t +
    +MENU:DOWN + j, C-n, DOWN - Show tab menu + Move to the next item
    - T -
    +MENU:UP + + k, C-p, UP - Open current page as new tab + Move to the previous item
    - C-t +
    +MENU:LINE_UP + K - Open link as new tab + Scroll up one item
    - } +
    +MENU:LINE_DOWN + J - Switch to next tab + Scroll down one item
    - { +
    +MENU:TOP + C-a - Switch to previous tab + Move to the first item
    - C-q +
    +MENU:LAST + C-e - Close current tab + Move to the final item
    -

    - Search -

    - - - + + - - - + + - - + + -
    - /, C-s +
    +MENU:NEXT + C-v, C-f - Search forward + Go to the next page
    - n +
    +MENU:PREV + ESC v, C-b - Next match + Go to the previous page
    - w +
    +MENU:SEARCH_FORE + C-s, / - Toggle wrapping mode in searches + Search forward
    -

    - Mark management -

    - - + + + + + + + + + + + + + + + + + + + + + + + - + + - + + - + + -
    +MENU:SEARCH_BACK + + C-r, ? + Search backward +
    +MENU:SEARCH_NEXT + + n + Search for the next match
    +MENU:SEARCH_PREV + + N + Search for the previous match
    +

    Line-editing Mode

    +
    + LINEEDIT:FORWARD + - C-SPC + C-f, RIGHT - Set/unset mark + Move cursor forward
    +LINEEDIT:BACK + - P + C-b, LEFT - Go to the previous mark + Move cursor backward
    +LINEEDIT:BS + - N + C-h, BKSPC - Go to the next mark + Delete previous character
    +LINEEDIT:DEL + - " + C-d - Mark all occurrences of a regular expression + Delete current character
    -

    - Miscellany -

    - - - + + - + + - + + - + + - + + - + + - + + - + + - + +
    - ! +
    +LINEEDIT:KILL_AFTER + + C-k - Execute shell command + Delete everything after cursor
    +LINEEDIT:KILL_BEFORE + - M-c + C-u - Invoke w3m function + Delete everything before cursor
    +LINEEDIT:TOP + - H, ? + C-a - Show help panel + Move to the beginning of the line
    +LINEEDIT:BOTTOM + - o + C-e - Show options panel + Move to the end of the line
    +LINEEDIT:PREV + - C-k + C-p, UP - Show cookie jar + Fetch the previous string from the history list
    +LINEEDIT:NEXT + - C-c + C-n, DOWN - Interrupt + Fetch the next string from the history list
    +LINEEDIT:COMPLETE + - C-z + TAB, SPC - Suspend w3m + Try to complete filename
    +LINEEDIT:EDITOR + - q + C-o - Quit (with confirmation dialog) + Edit with external editor
    +LINEEDIT:ACCEPT + - Q + RET - Quit without confirmation + Accept input line
    -

    + +

    - Mouse operation + Mouse Operation

    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 xterm or kterm).

    - - +

    An introduction to configure mouse actions is provided + with README.mouse. +

    +
    + + + + + + + + + @@ -2126,33 +2335,13 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p
    Operation + Description +
    left click - 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. +First:
    +Moves the cursor to the place indicated by the mouse pointer.
    +Then:
    +Follows a hyperlink the cursor is currently located and the mouse points to.
    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.
    -

    - Key customization -

    -

    - You can customize the key bindings (except the line-editing keymap) - in a ~/.w3m/keymap file. For example, -

    -
    -
-   keymap C-o NEXT_PAGE
-
-
    -

    - binds the NEXT_PAGE function (normally bound to SPC and C-v) - to control-o. See README.func for a - list of available functions. Original and Lynx-like keymap - definitions are provided (keymap.default - and keymap.lynx) as examples. -

    -

    - Local CGI + Local CGI scripts

    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

  • The /cgi-bin/ directory. You can map /cgi-bin/ to any directory you - like in the option setting panel (the Directory corresponds to + like in the options setting panel (the Directory corresponds to /cgi-bin field). You can specify multiple paths separated by - :, 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: + :, 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: + 
    •   w3m -o cgi_bin=/path/to/cgi-bin file:/cgi-bin/script.cgi
    - It is not recommended to include the current directory to this path. -

    - The CGI script can use the special header w3m-control: to + The CGI script can use the special header + w3m-control: to control w3m. This field can take any function (see README.func), and the specified function is invoked after the document is displayed. For example, the CGI output 

    -
 Content-Type: text/plain
 W3m-control: BACK
-

    will display a blank page and delete that buffer immediately. @@ -2203,34 +2391,30 @@ W3m-control: BACK the script is invoked. The next example 

    -
 Content-Type: text/plain
 W3m-control: DELETE_PREVBUF
-
 contents.....

    will override the current buffer.

    - 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 w3m-control: can + contain only one function, but you can + include more than one w3m-control: + line in the HTTP header. In addition, you can specify an argument to the GOTO function: 

    -
 Content-Type: text/plain
 W3m-control: GOTO http://www.example.org/
-

    This example works exactly the same way as the Location header: 

    -
 Content-Type: text/plain
 Location: http://www.example.org/
-

    Note that this header has no effect when the CGI script is invoked -- cgit v1.2.3