From 72f72d64a422d6628c4796f5c0bf2e508f134214 Mon Sep 17 00:00:00 2001 From: Tatsuya Kinoshita Date: Wed, 4 May 2011 16:05:14 +0900 Subject: Adding upstream version 0.5.1 --- doc/FAQ.html | 287 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 287 insertions(+) create mode 100644 doc/FAQ.html (limited to 'doc/FAQ.html') diff --git a/doc/FAQ.html b/doc/FAQ.html new file mode 100644 index 0000000..6973e2e --- /dev/null +++ b/doc/FAQ.html @@ -0,0 +1,287 @@ + + +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 +
+
```
+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? 
+
```
+
+with 2,3,4 or 5. +
+
Does w3m support monochrome display?
+
Yes. You may either +
1. Answer the above mentioned 'configure' question with 1, or +
2. Invoke w3m with the -M option, or +
3. 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 ~/.mailcap or /etc/mailcap. +
+
```
+image/*; display %s
+
```
+
+You can specify external viewers of other file types as well: +
+
```
+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. +
+
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 +
+
+ + -- 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?