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 ++++++++ doc/HISTORY | 1989 +++++++++++++++++++++++++++++++++++++++++++++++++++ doc/MANUAL.html | 537 ++++++++++++++ doc/README | 121 ++++ doc/README.cygwin | 151 ++++ doc/README.dict | 68 ++ doc/README.func | 145 ++++ doc/README.img | 211 ++++++ doc/README.m17n | 451 ++++++++++++ doc/README.mouse | 61 ++ doc/README.pre_form | 45 ++ doc/README.tab | 45 ++ doc/STORY.html | 209 ++++++ doc/keymap.default | 142 ++++ doc/keymap.lynx | 146 ++++ doc/menu.default | 35 + doc/menu.submenu | 44 ++ doc/w3m.1 | 192 +++++ 18 files changed, 4879 insertions(+) create mode 100644 doc/FAQ.html create mode 100644 doc/HISTORY create mode 100644 doc/MANUAL.html create mode 100644 doc/README create mode 100644 doc/README.cygwin create mode 100644 doc/README.dict create mode 100644 doc/README.func create mode 100644 doc/README.img create mode 100644 doc/README.m17n create mode 100644 doc/README.mouse create mode 100644 doc/README.pre_form create mode 100644 doc/README.tab create mode 100644 doc/STORY.html create mode 100644 doc/keymap.default create mode 100644 doc/keymap.lynx create mode 100644 doc/menu.default create mode 100644 doc/menu.submenu create mode 100644 doc/w3m.1 (limited to 'doc') 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 +
+
+ + diff --git a/doc/HISTORY b/doc/HISTORY new file mode 100644 index 0000000..b8f5b94 --- /dev/null +++ b/doc/HISTORY @@ -0,0 +1,1989 @@ +2001/3/23 ============================================================== +From: Hironori Sakamoto +Subject: [w3m-dev 01807] Re: w3m-0.2.0 +* url.c doesn't compile when USE_NNTP or __EMX__ is defined. +* patch for EWS4800 +* when #define USE_SSL and #undef USE_SSL_VERIFY, rc.c and url.c + doesn't compile. (problems about ssl_forbid_method) +* when saveBufferDelNum and del==TRUE, patterns before ":" are + deleted twice. +* bugfix about saving history. + +From: TSUCHIYA Masatoshi +Subject: [w3m-dev 01810] deflate (was: w3m-0.2.0) +deflate patch in 0.2.0 doesn't work on http://cvs.m17n.org/~akr/diary/ . + +From: Fumitoshi UKAI +Subject: [w3m-dev 01808] Re: w3m-0.2.0 +w3m doesn't compile on GNU/Linux and glibc2.2 because it lacks +sin.ss_len. + +From: Hironori Sakamoto +Subject: [w3m-dev-en 00399] Re: w3m-0.2.0 + >> From: Dan Fandrich + >> Version 0.2.0 still contains the following bugs which I fixed two months + >> ago and sent patches for to this list, namely: + >> - core dumps on startup if given a URL requiring a needsterminal mailcap + >> handler + >> - destroys most of an existing ~/.mailcap file without warning when editing + >> - mailcap handling is still wrong as MIME type should be case insensitive + >> - private mailcap extension has an illegal name + +From: SATO Seichi +Subject: w3m regex bugs +w3m coredumps when passing $* as a search string. + +2001/3/22 ============================================================== + +From: Hironori Sakamoto +Subject: [w3m-dev 01664] Re: Patch for anonymizer.com +Don't call cleanupName() when the URL is http:///: ... + +From: Hironori Sakamoto +Subject: [w3m-dev 01670] Re: w3m-0.1.11-pre-kokb24-test1 +strcpy/strncpy in Str.c are replaced with bcopy. + +From: TSUCHIYA Masatoshi +Subject: [w3m-dev 01618] backend patch +Subject: [w3m-dev 01671] backend patch for w3m-0.1.11-pre-kokb24-test1 +A patch for w3m to work as a client. (-backend patch) + +From: hsaka@mth.biglobe.ne.jp (Hironori Sakamoto) +Subject: [w3m-dev 01673] SEGV in append_frame_info() +Improvement of illegal frame handling. + +From: hsaka@mth.biglobe.ne.jp (Hironori Sakamoto) +Subject: [w3m-dev 01674] image map +w3m doesn't follow anchors from client-side image map when the URLs +are like "#test". + +From: hsaka@mth.biglobe.ne.jp (Hironori Sakamoto) +Subject: [w3m-dev 01675] goto label +Changed w3m not to reload the document when following label-only URL +like #label. + +From: Tsutomu Okada +Subject: [w3m-dev 01676] Re: w3m-0.1.11-pre-kokb24-test1 +Subject: [w3m-dev 01678] Re: w3m-0.1.11-pre-kokb24-test1 + +From: Hironori Sakamoto +Subject: [w3m-dev 01680] Re: w3m-0.1.11-pre-kokb24-test1 +To remove the compiler warnings + +From: Hironori Sakamoto +Subject: [w3m-dev 01684] Re: http://cvs.m17n.org/~akr/diary/ +application/x-deflate support. + +From: Moritz Barsnick +Subject: [w3m-dev-en 00318] Information about current page +Subject: [w3m-dev-en 00320] Re: Information about current page +Subject: [w3m-dev-en 00322] Re: Information about current page +Subject: [w3m-dev-en 00323] Buglet (Was: Re: Information about current page) +Changes 'URL of the current anchor' on the info page into +'full' URL. When the cursor is on a form element, +`Method/type of current form' will be displayed. + +From: c603273@vus069.trl.telstra.com.au (Brian Keck) +Subject: [w3m-dev-en 00343] patch for proxy user:passwd on command line +Subject: [w3m-dev-en 00351] Re: patch for proxy user:passwd on command line +This patch to w3m-0.1.11-pre-kokb23 adds the lynx-like option + + -pauth username:password + +so I don't have to retype username & password every time I run w3m, +which is often. It's so simple I wonder whether it's against policy, +but it would be nice for me & some others if it was in the official +0.1.11. + +From: Hironori Sakamoto +Subject: [w3m-dev 01772] Re: visited anchor +Subject: [w3m-dev 01773] Re: visited anchor + * visited anhor color support. + * textlist based history implementation. + * history URLs are stored in a hash table. + * the implementation of rules are changed. + +From: Hironori Sakamoto +Subject: [w3m-dev 01786] Re: w3m-0.1.11-pre-hsaka24 +Subject: [w3m-dev 01787] Re: w3m-0.1.11-pre-hsaka24 + * Improvement of illegal frame handling. + +From: Hironori Sakamoto +Subject: [w3m-dev 01788] Re: w3m-0.1.11-pre-hsaka24 + +From: Hironori Sakamoto +Subject: [w3m-dev 01792] Re: w3m-0.1.11-pre-hsaka24 +search algorithm in retrieveAnchor() is changed from linear search +to binary search. + +From: hsaka@mth.biglobe.ne.jp (Hironori Sakamoto) +Subject: [w3m-dev 01793]
+make type attribute of
tag effective not only for the
+element but also for all
tags that follows the first +type-specified
tag. + +From: hsaka@mth.biglobe.ne.jp (Hironori Sakamoto) +Subject: [w3m-dev 01801] some fixes. +Bugfix of frame + +Subject: IPv6 support for w3m's ftp +From: Hajimu UMEMOTO +IPv6 support for FTP. + +2001/3/16 ============================================================= +From: hsaka@mth.biglobe.ne.jp (Hironori Sakamoto) +Subject: [w3m-dev 01711] Authorization +* http://user:pass@hostname/ support. + +From: hsaka@mth.biglobe.ne.jp +Subject: [w3m-dev 01724] buf->type when mailcap is used. + +From: hsaka@mth.biglobe.ne.jp (Hironori Sakamoto) +Subject: [w3m-dev 01726] anchor jump too slow by TAB-key on STDIN. +* when moving from anchor to anchor by TAB on the document read + from stdin, the movement is very slow because currentdir() is invoked + on each TAB. + +From: sakane@d4.bsd.nes.nec.co.jp (Yoshinobu Sakane) +Subject: [w3m-dev 01727] C-z when stdin + +From: Hironori Sakamoto +Subject: [w3m-dev 01729] ignore_null_img_alt +* when ignore_null_img_alt is OFF, no img link is displayed when + no ALT attribute is specified. + +From: Hironori Sakamoto +Subject: [w3m-dev 01730] Re:
in a table +Improvement of
. + +From: Hironori Sakamoto +Subject: [w3m-dev 01731] completion list +When completing a filename, the candidates of the completion +will be displayed like this: + +----- Completion list ----- +X11R6/ compat/ include/ libdata/ local/ nfs/ ports/ share/ +bin/ games/ lib/ libexec/ mdec/ obj/ sbin/ src/ +(Load)Filename? /usr/ + + +From: Kiyokazu SUTO +Subject: [w3m-dev 01733] A patch concerning SSL +The following two improvements are done about SSL: +1. a new option ``ssl_forbid_method'' is added. +2. an error message is displayed when w3m fails to establish an + SSL connection. + +From: Kiyokazu SUTO +Subject: [w3m-dev 01735] Re: A patch concerning SSL +Subject: [w3m-dev 01737] Re: A patch concerning SSL +1. the data type of ssl_forbid_method is changed from P_STRING to P_SSLPATH. +2. Error message log function. + +From: kiwamu +Subject: [w3m-dev 01739] wheel mouse patch + +From: Fumitoshi UKAI +Subject: [w3m-dev 01742] w3mmee 0.1.11p16-6 segfault +w3mmee 0.1.11p16-6 segfaults depending on the content of mime.types. + +From: Hironori Sakamoto +Subject: [w3m-dev 01752] SEGV in search_param() + > >> * w3m -o 1 causes SEGV. + +From: Hironori Sakamoto +Subject: [w3m-dev 01753] empty .. have no

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?