aboutsummaryrefslogtreecommitdiffstats
path: root/doc/README
blob: f4be7e60474ac160758d4084ceb5eb311146550f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
	w3m: WWW wo Miru Tool  version 0.5.3	Jan 15, 2011
		(C) Copyright Akinori ITO
			      Hironori SAKAMOTO
			      Fumitoshi UKAI

1. Introduction

     w3m is a pager with WWW capability. It IS a pager, but it can be
used as a text-mode WWW browser.

     The features of w3m are as follows:

* When reading HTML document, you can follow links and view images
  (using external image viewer).
* It has 'internet message mode', which determines the type of document
  from header. If the Content-Type: field of the document is text/html,
  that document is displayed as HTML document.
* You can change URL description like 'http://hogege.net' in plain text
  into link to that URL.

Current problems are:

* Online manuals are poor.

w3m is known to work on these platforms.

      SunOS 4.1.x
      HP-UX 9.x, 10.x
      Solaris 2.5.x, 2.6, 8, 9
      Linux 2.0.*/2.2.*/2.4.*/2.6.*
      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 Cygwin b20.1, 1.1.x, 1.3.x
      MS-DOS with DJGPP and WATT32 packet driver
      MacOS X Server
      MacOS X 10.1, 10.2, 10.3, 10.4

2. Installation

Follow these instructions to install w3m.  

 - You need latest version of GC library (at least 6.1?).
   You can get GC library from 
   http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/

   Note: if you're using GC library 6.1, you should install gc.h 
   to PREFIX/include:
	# cp gc-6.1/include/gc.h PREFIX/include

 - Run configure.
   % ./configure

 - do make
   % make

 - do make install
   # make install

MACHINE/OS specific notices:

HP-UX
	If you want to use HP C compiler, answer

		Input your favorite C-compiler.
		(Default: cc) cc -Aa -D_HPUX_SOURCE

	If you use just 'cc' without options, you can't compile w3m.
	If you are using gcc, no option is needed. 

OS/2
	You can compile w3m using emx. First you have to do
	is to compile GC library with

		cd gc
		make -f EMX_MAKEFILE

	then compile w3m. I heard that OS/2 console can't 
	display color, you had better compile w3m without
	color capability.

Windows
	To compile w3m on MS-Windows, you have to use Cygwin with
	development tools.
	Read README.cygwin for more details.

3. Copyright

  (C) Copyright 1994-2002 by Akinori Ito
  (C) Copyright 2002-2011 by Akinori Ito, Hironori Sakamoto, Fumitoshi Ukai

4. License

  Use, modification and redistribution of this software is hereby granted, 
  provided that this entire copyright notice is included on any copies of 
  this software and applications and derivations thereof.

  This software is provided on an "as is" basis, without warranty of any
  kind, either expressed or implied, as to any matter including, but not
  limited to warranty of fitness of purpose, or merchantability, or
  results obtained from use of this software.

5. Author

Initial author:
	Akinori Ito
	Faculty of Engineering, Tohoku University
	aito@fw.ipsj.or.jp

Feel free to send your opinion to:
	http://w3m.sourceforge.net/
	https://sourceforge.net/projects/w3m/