From 1d0ba25a660483da1272a31dd077ed94441e3d9f Mon Sep 17 00:00:00 2001 From: Tatsuya Kinoshita Date: Sat, 2 Jan 2021 09:20:37 +0900 Subject: New upstream version 0.5.3+git20210102 --- doc/FAQ.html | 1040 ++++++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 756 insertions(+), 284 deletions(-) (limited to 'doc/FAQ.html') diff --git a/doc/FAQ.html b/doc/FAQ.html index ed2a704..ca82c67 100644 --- a/doc/FAQ.html +++ b/doc/FAQ.html @@ -1,291 +1,763 @@ - - -W3M FAQ - - -

Frequently Asked Questions and Answers about w3m

-Akinori Ito
-aito@fw.ipsj.or.jp
-Corrected by Tom Berger <tom.be@gmx.net> -

Index -

-
-

General Questions, How to Get It, Required Environment

How do I pronounce "w3m"?
-
Why is it called "w3m"?
-
On which platforms does w3m work?
-
Where can I get more information about w3m?
-
Is there a mailing list for w3m?
-
Are there any binary distributions?
-

Compile and Install
-
-
Options, Commands, Usage
-
- w3m quits if started without parameters. What's wrong?
  -
- w3m starts with black characters on a black screen. How do I change this?
  -
- Does w3m support colours?
  -
- Does w3m support monochrome display?
  -
- How do I shift the display?
  -
- How do I move from anchor to anchor?
  -
- Netscape displays a word red, but w3m doesn't. Why?
  -
- How do I change the colour of anchor-/image-/form links?
  -
- w3m doesn't seem to use the variable EDITOR. Why?
  -
- How do I quit a search or URL text input?
  -
-
-
Questions about WWW usage
-
- How do I fill in forms with w3m?
  -
- Seems like w3m is slower than Netscape or Lynx. Why?
  -
- Loading time doesn't decrease when loading a previously seen page
  -
- How do I download a linked file?
  -
- How do I specify a proxy server?
  -
- w3m freezes when I invoke an external browser.
  -
- How do I change the default image viewer?
  -
- How do I enter a URL?
  -
- w3m appends a URL to the former one despite of having cleared the line with Ctrl-u. What to do?
  -
-
-
Misc
-
- What is w3m's configuration file?
  -
- What are these w3mxxxx files in my ~/.w3m directory for?
  -
-
-
-
General Questions, How to Get It, Required Environment
-
-
-
How do I pronounce "w3m"?
-
It's "W-three-M". It doesn't rhyme with "pteranodon". -
-
Why is it called "w3m"?
-
It's an abbreviation of "WWW-wo-Miru", which is Japanese for -"See the WWW". So in English the name of this browser would be -something like "stw3". -
-
On which platforms does w3m work?
-
It runs on various versions of Unix, since version 990226 on OS/2 and since -version 990303 also on MS-Windows with Cygwin32. -
-Current versions have been confirmed to run on: -
- SunOS 4.1.x -
- HP-UX 9.x, 10.x -
- Solaris 2.5.x, 2.6, 8 -
- Linux 2.0.30 -
- FreeBSD 2.2.8, 3.1, 3.2, 4.6 -
- NetBSD/macppc, m68k -
- EWS4800 Rel.12.2 Rev.A -
- Digital UNIX: v3.2D, v4.0D -
- IRIX 5.3, IRIX 6.5 -
- OS/2 with emx -
- Windows 9x/NT with Cygwin32 b20.1 -
- MS-DOS with DJGPP and WATT32 packet driver -
- MacOS X Server -
- MacOS X 10.1, 10.2 -
-
Where can I get more information about w3m?
-
At the English w3m home page. -
Is there a mailing list for w3m?
-
There is a mailing list for developpers (w3m-dev-en). Please see -w3m page -for details. You may also mail your comments to the author. -
Are there any binary distributions?
-
So far there are only binaries for the win/cygnus32 version. You can get -them from here. -Contact the author if you want to contribute binaries for other platforms. -
-
-
-
-Up to index -
-
-
Compile and Install
-No problem :-) -
Options, Commands, Usage
-
-
-
w3m quits if started without parameters. What's wrong?
-
w3m is a pager. Therefore it just quits when invoked without any -arguments. Possible arguments are: -
1. A filename or an URL -
2. Pipe from standard input -
3. The -B option (Show bookmark file) -
4. The -v option (visual startup) -
5. From a specified HTTP_HOME or WWW_HOME variable -
-
-
w3m starts with black characters on black background. How do I change -this?
-
-When compiled with colour support, w3m assumes a white background and therefore -displays black characters. -
-You may either change the background colour of your terminal (e.g. with the -bg -option in a xterm) or take these steps: -
- invoke w3m with 'w3m -M' (for monochrome), -
- type 'o' for getting to the options screen -
- Mark 'Display with colour' as ON and choose an arbitrary colour. -Click on [OK]. -
-
-
Does w3m support colours?
-
Yes. When you run './configure', answer the question -
+ + + + + + W3M FAQ + + +
+ Frequently Asked Questions and Answers about w3m +
+
+ Akinori Ito <aito@fw.ipsj.or.jp>
+ Corrected by Tom Berger <tom.be@gmx.net> +
+
+ + Index + +
+
- + + + General Questions, How to Get It, Required Environment + + +
- + + + Compile and Install + + +
- + + + Options, Commands, Usage + + +
- + + + Questions about WWW usage + + +
- + + + Miscellaneous + + +
+
+ + General Questions, How to Get It, Required Environment + +
+
+
+ + How do I pronounce w3m? + +
+
+
+ It's W-three-M. It doesn't rhyme with pteranodon. +
+
+
+ + Why is it called w3m? + +
+
+
+ It's an abbreviation of WWW-wo-Miru, which is Japanese + for See the WWW. So in English the name of this browser + would be something like stw3. +
+
+
+ + On which platforms does w3m work? + +
+
+
+ It runs on various versions of Unix, since version 990226 on OS/2 + and since version 990303 also on MS-Windows with Cygwin32. +
+
+ More recent versions have been confirmed to run on: +
+
+
+ SunOS 4.1.x +
+
+ HP-UX 9.x, 10.x +
+
+ Solaris 2.5.x, 2.6, 8 +
+
+ Linux 2.0.1 to 3.17 +
+
+ FreeBSD 2.2.8, 3.1, 3.2, 4.6 +
+
+ NetBSD/macppc, m68k +
+
+ EWS4800 Rel.12.2 Rev.A +
+
+ Digital UNIX: v3.2D, v4.0D +
+
+ IRIX 5.3, IRIX 6.5 +
+
+ OS/2 with emx +
+
+ Windows 9x/NT with Cygwin32 b20.1 +
+
+ MS-DOS with DJGPP and WATT32 packet driver +
+
+ MacOS X Server +
+
+ MacOS X 10.1, 10.2 +
+
+
+
+ + Where can I get more information about w3m? + +
+
+
+ At the + English w3m + home page. +
+
+
+ + Is there a mailing list for w3m? + +
+
+
+ There is a mailing list for developers (w3m-dev-en). Please see + the w3m home + page for details. You may also mail your comments to + the author. +
+
+
+ + Are there any binary distributions? + +
+
+
+ So far there are only binaries for the win/cygnus32 version. + + Contact the author if you + want to contribute binaries for other platforms. +
+
+
+
+ + Up to index + +
+
+ + Compile and Install + +
+
+ No problem :-) +
+
+ + Options, Commands, Usage + +
+
+
+ + w3m quits if started without parameters. What's wrong? + +
+
+
+ w3m is a pager. Therefore it just quits when invoked + without any arguments. It keeps running +
+
+
+ with a filename or URL as argument +
+
+ with data piped from standard input +
+
+ when invoked with option -B to show the bookmark file +
+
+ when invoked with option -v to welcome users with a built-in page +
+
+ with specified HTTP_HOME or WWW_HOME variable +
+
+
+
+ + w3m starts with black characters on a black background. How do I + change this? + +
+
+
+ When compiled with color support, w3m assumes a white background + and therefore displays black characters. +
+
+ You may either change the background color of your terminal + (e.g. with the -bg option in a xterm) or take these steps +
+
+
+ invoke monochrome mode of w3m with w3m -M +
+
+ type o to get to the options setting panel +
+
+ mark Display with color as YES and choose an + arbitrary color +
+
+ click on [OK]. +
+
+
+
+ + Does w3m support colors? + +
+
+
+ Yes. When you run ./configure, answer the question +

-Let's do some configurations. Choose config option among the list." + Let's do some configurations. Choose config option among the list. -1 - Baby model (no color, no menu, no mouse, no cookie, no SSL) -2 - Little model (color, menu, no mouse, no cookie, no SSL) -3 - Mouse model (color, menu, mouse, no cookie, no SSL) -4 - Cookie model (color, menu, mouse, cookie, no SSL) -5 - Monster model (with everything; you need openSSL library) -6 - Customize -Which? + 1 - Baby model (no color, no menu, no mouse, no cookie, no SSL) + 2 - Little model (color, menu, no mouse, no cookie, no SSL) + 3 - Mouse model (color, menu, mouse, no cookie, no SSL) + 4 - Cookie model (color, menu, mouse, cookie, no SSL) + 5 - Monster model (with everything; you need openSSL library) + 6 - Customize + Which?
-
-with 2,3,4 or 5. -
-
Does w3m support monochrome display?
-
Yes. You may either -
-
Answer the above mentioned 'configure' question with 1, or -
Invoke w3m with the -M option, or -
Type 'o' within w3m to enter the options screen and turn off colour display -mode. -
-
How do I shift the display?
-
You can shift the display by moving the cursor to the edge of the screen. You -may also use the ">"/"<" or "."/"," keys. -
-Another idea would be adjusting the xterm with the -geometry option (e.g. -something like 'xterm -geometry 110x45 -bg white -name w3m -e w3m -B'). -
How do I move from anchor to anchor?
-
You can move to the next anchor using TAB. ESC TAB moves cursor to the previous anchor. -
-
Netscape displays a word red, but w3m doesn't. Why?
-
w3m doesn't support <FONT COLOR=".."> tags. It won't be impossible to implement this, but I think it would make the document more difficult to read. -
-
How do I change the colour of anchor-/image-/form links?
-
Type 'o' within w3m to get the 'options' screen. You can change these -settings there. -
-
w3m doesn't seem to use the variable EDITOR. Why?
-
Go to the 'options' screen using the "o" key. Any entry in the 'Editor' field will override the environment variable. -
-If you want to use the editor specified by EDITOR blank the field and push [OK]. -
-
How do I quit a search or URL text input?
-
Clear input text using Ctrl-u and hit RETURN. -
-
-
-
-Up to index -
-
-
Questions about WWW usage
-
-
-
How do I fill in forms with w3m?
-
Form input fields are displayed in red (or reverse). Move the cursor to -them and hit RETURN. Then, -
-
if it is a text input field, put in your text on the bottom line, -
if it is a radiobutton or checkbox, that item is selected, -
if it is a textarea, an editor is spawned, -
if it is 'submit' or 'reset', well, just do it. -
-
Seems like w3m is slower than Netscape or Lynx. Why?
-
w3m renders a HTML document in two passes. Therefore it displays the documentnot before having read the entire document. -
-Netscape or Lynx display the document before having read the whole page, -and therefore seem faster. -
-
Loading time doesn't decrease when loading a previously seen page
-
w3m doesn't have its own cache. Therefore, it reads the document -from the server each time it accesses it. If possible, use a cache server. -
-
How do I download a linked file?
-
Use 'a' (or 'd' with Lynx-like keybindings) or ESC RET. If you want to download an inline image, use ESC 'I'. -
-
How do I specify a proxy server?
-
Set the environment variable HTTP_PROXY or use the option setting panel -("o" key). For example, if you want to use port 8000 of proxy.hogege.com, specify -
-
- http://proxy.hogege.com:8000/ -
-
-
w3m freezes when I invoke an external browser.
-
Enter w3m's option screen using the 'o' key and specify -
-
- netscape %s & -
-
-(if you are using netscape). -
-
How do I change the default image viewer?
-
By default w3m uses xv to view images. If you want to change it into, let's say, 'display', add the following line to ~/.w3m/mailcap or /etc/mailcap. -
+
+ with 2, 3, 4, or 5. +
+
+
+ + Does w3m support monochrome displays? + +
+
+
+ Yes. You may either +
+
+
+ Answer the above-mentioned configure question with 1, + or +
+
+ Invoke w3m with the -M option, or +
+
+ Type o within w3m to enter the options setting panel and turn + off color display mode. +
+
+
+
+ + How do I shift the display? + +
+
+
+ You can shift the display by moving the cursor to the edge of + the screen. You may also use the following commands +
+
+
SHIFT_LEFT and SHIFT_RIGHT, bound to the keys > and <
+
SHIFT_LEFT1 and SHIFT_RIGHT1, bound to the keys . and ,
+
+
+ Another idea would be adjusting the xterm with the -geometry + option e.g. something like +
+
xterm -geometry 110x45 -bg white -name w3m -e w3m -B
+
+
+ + How do I move between hyperlinks? + +
+
+
+ + You can move to the next hyperlink + using TAB. ESC + TAB moves the cursor to the previous hyperlink. (see + Section + Functions and Key bindings of w3m's manual) + +
+
+
+ + Graphical browsers display a word red, but w3m doesn't. Why? + +
+
+
+ w3m doesn't support the attribute COLOR="..." of HTML. It wouldn't + be impossible to implement this, but I think it would make + documents more difficult to read. +
+
+
+ + How do I change the colors for hyperlinks, images and form fields? + +
+
+
+ Type o within w3m to get the options panel. You + can change these settings there. +
+
+
+ + w3m doesn't seem to use the variable EDITOR. Why? + +
+
+
+ Go to the options setting panel using the o key. Any + entry in the Editor field overrides the environment + variable. +
+
+ If you want to use the editor specified by EDITOR, blank the + field and save the settings using the button [OK]. +
+
+
+ + How do I quit a search or URL text input? + +
+
+
+ Clear input text using CTRL-u and hit RETURN. +
+
+
+
+ + Up to index + +
+
+ + Questions about WWW usage + +
+
+
+ + How do I fill in forms with w3m? + +
+
+
+ Form input fields are displayed in red (or reverse). Move the + cursor to them. Then, if it is +
+
+
+ a text input field, hit RETURN + put in your text on the bottom line. Press + RETURN again +
+
+ a radiobutton or checkbox, pressing + RETURN changes or toggles the selection +
+
+ a textarea, pressing + RETURN spawns an editor +
+
+ a submit or reset field, + the respective action is performed. +
+
+
+
+ + Seems like w3m is slower than some other browsers. Why? + +
+
+
+ w3m renders a HTML document in two passes. Therefore it doesn't + start to display the document until it has finished reading it. +
+
+ Most other browsers display the document before having read the + whole page, and therefore seem faster. +
+
+
+ + Loading time doesn't decrease when loading a previously seen + page. + +
+
+
+ w3m doesn't have its own cache. Therefore, it reads the document + from the server each time it accesses it. If possible, use a + cache server. +
+
+
+ + How do I download a linked file? + +
+
+
+ Use a (or d with Lynx-like keybindings) or + ESC RET. + If you want to download an inline image, use + ESC I. (see + Section + Functions and Key bindings of w3m's manual) +
+
+
+ + How do I specify a proxy server? + +
+
+
+ Set the environment variables HTTP_PROXY, HTTPS_PROXY, GOPHER_PROXY + and FTP_PROXY, or use the options setting panel (o key). For + example, if you want to use port 8000 of proxy.example.org, specify +
+
http://proxy.example.org:8000/
+
+ +
+ + How do I change the default image viewer? + +
+
+
+ By default w3m uses xv to view images. If you want to change it + into, let's say, display, add the following line to + ~/.w3m/mailcap or /etc/mailcap: +

-image/*; display %s + image/*; display %s
-
-You can specify external viewers of other file types as well: -
+
+ You can specify external viewers of other file types as well: +

-image/*; display %s -application/postscript; ghostview %s -application/x-dvi; xdvi %s + image/*; display %s + application/postscript; ghostview %s + application/x-dvi; xdvi %s
-
How do I enter a URL?
-
Type SHIFT-U -
-
w3m appends a URL to the former one despite of having cleared the line -with Ctrl-u. What to do?
-
Enter the complete adress, e.g. http://www.slashdot.org. -
-
-
-
-Up to index -
-
-
Miscellaneous
-
-
-
What is w3m's configuration file?
-
It is ~/.w3m/config. -With this file, you can adjust w3m's behavior by changing values of options -that are described to be varied with the option setting panel. -Each line contains setting for one option, which is a pair of an option name -and its value with a space as a separator. -
-
What are these w3mxxxx files in my ~/.w3m directory for?
-
These are temporary files used by w3m when reading documents from a -WWW server. They are not cache files and are usually deleted when w3m is -terminated. If there remain any temp files, please remove them by yourself. -
-
-
-
-
-Up to index -
-
- - +
+
+ + How do I enter a URL? + +
+
+
+ Type U +
+
+
+ + w3m appends a URL to the former one even when I clear the line + with CTRL-u. What should I do? + +
+
+
+ Enter the complete address, e.g. http://www.slashdot.org. +
+
+
+
+ + Up to index + +
+
+ + Miscellaneous + +
+
+
+ + What is w3m's configuration file? + +
+
+
+ It is ~/.w3m/config. +
+ +
+ With this file, each user can adjust w3m's behavior by changing + the values of options whose effects are described in the options + setting panel. Each line contains one option setting, consisting + of an option name and its value with a space as a separator. +
+ +
Without a user-specific configuration file, w3m honours + the system wide configuration file /etc/w3m/config. +
+ +
+
+ + What are these w3mxxxx files in my ~/.w3m directory for? + +
+
+
+ These are temporary files used by w3m when reading documents + from a WWW server. They are not cache files and are usually + deleted when w3m is terminated. If any temp files are left + behind, please remove them yourself. +
+
+
+
+ + Up to index + +
+ + -- cgit v1.2.3

Frequently Asked Questions and Answers about w3m

General Questions, How to Get It, Required Environment

How do I pronounce "w3m"?

Why is it called "w3m"?

On which platforms does w3m work?

Where can I get more information about w3m?

Is there a mailing list for w3m?

Are there any binary distributions?

Compile and Install

Options, Commands, Usage

w3m quits if started without parameters. What's wrong?

w3m starts with black characters on a black screen. How do I change this?

Does w3m support colours?

Does w3m support monochrome display?

How do I shift the display?

How do I move from anchor to anchor?

Netscape displays a word red, but w3m doesn't. Why?

How do I change the colour of anchor-/image-/form links?

w3m doesn't seem to use the variable EDITOR. Why?

How do I quit a search or URL text input?

Questions about WWW usage

How do I fill in forms with w3m?

Seems like w3m is slower than Netscape or Lynx. Why?

Loading time doesn't decrease when loading a previously seen page

How do I download a linked file?

How do I specify a proxy server?

w3m freezes when I invoke an external browser.

How do I change the default image viewer?

How do I enter a URL?

w3m appends a URL to the former one despite of having cleared the line with Ctrl-u. What to do?

Misc

What is w3m's configuration file?

What are these w3mxxxx files in my ~/.w3m directory for?