aboutsummaryrefslogtreecommitdiffstats
path: root/doc/w3m.1
blob: 81ace729fe81be20113a0c3704aef0af695e9864 (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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
.nr N -1
.nr D 5
.TH W3M 1 Local
.UC 4
.SH NAME
w3m \- a text based Web browser and pager
.SH SYNOPSIS
.B w3m
[options] [URL or filename]
.PP
.SH DESCRIPTION
.\" This defines appropriate quote strings for nroff and troff
.ds lq \&"
.ds rq \&"
.if t .ds lq ``
.if t .ds rq ''
.\" Just in case these number registers aren't set yet...
.if \nN==0 .nr N 10
.if \nD==0 .nr D 5
.I
w3m
is a World Wide Web (WWW) text based client. It has English and
Japanese help files and an option menu and can be configured to
use either language. It will display hypertext markup language
(HTML) documents containing links to files residing on the local
system, as well as files residing on remote systems. It can
display HTML tables and frames.
In addition, it can be used as a "pager" in much the same manner
as "more" or "less".
Current versions of
.I
w3m
run on
Unix (Solaris, SunOS, HP-UX, Linux, FreeBSD, and EWS4800)
and on
Microsoft Windows 9x/NT.
.PP
.SH OPTIONS
At start up, \fIw3m\fR will load any local
file or remote URL specified at the command
line.  For help with runtime options, press \fB"H"\fR
while running \fIw3m\fR.
Command line options are:
.PP
.TP
.B -t tab
set tab width
.TP
.B -r
ignore backspace effect
.TP
.B -l line
# of preserved line (default 10000)
.TP
.B -I charset
document charset
.TP
.B -O charset
display/output charset
.TP
.B -B
load bookmark
.TP
.B -bookmark file
specify bookmark file
.TP
.B -T type
specify content-type
.TP
.B -m
internet message mode
.TP
.B -v
visual startup mode
.TP
.B -M
monochrome display
.TP
.B -N
distribute multiple command line arguments to tabs. By default, a
stack of buffers is used
.TP
.B -F
automatically render frame
.TP
.B -dump
dump formatted page into stdout
.TP
.B -cols num
with stdout as destination; HTML is rendered to lines of \fInum\fR characters
.TP
.B -ppc count
specify the number of pixels per character (4.0...32.0).
Larger values will make tables narrower.  [default 8.0]
.TP
.B -ppl count
specify the number of pixels per line (4.0...64.0)
.TP
.B -dump_source
dump page source into stdout
.TP
.B -dump_head
dump response of HEAD request into stdout
.TP
.B -dump_both
dump HEAD and source into stdout
.TP
.B -dump_extra
dump HEAD, source, and extra information into stdout
.TP
.B -post file
use POST method with file content
.TP
.B -header string
insert string as a header
.TP
.B +<num>
goto <num> line
.TP
.B -num
show line number
.TP
.B -no-proxy
don't use proxy
.TP
.B -4
IPv4 only (-o dns_order=4)
.TP
.B -6
IPv6 only (-o dns_order=6)
.TP
.B -no-mouse
don't use mouse
.TP
.B -cookie
use cookie.
.TP
.B -no-cookie
don't use cookie
.TP
.B -graph
use graphic character
.TP
.B -no-graph
don't use graphic character
.TP
.B -s
squeeze multiple blank lines
.TP
.B -W
toggle wrap search mode
.TP
.B -X
don't use termcap init/deinit
.TP
.B -title [=TERM]
set buffer name to terminal title string. 
If TERM is specified, use the TERM style title configuration.
.TP
.B -o option=value
modify one configuration item with an explicitly given value; without \fIoption=value\fR, equivalent to -show-option
.TP
.B -show-option
show all available config option
.TP
.B -config file
specify config file
.TP
.B -help
show usage
.TP
.B -version
show w3m version
.TP
.B -reqlog
write request logfile
.TP
.B -debug
DO NOT USE
.SH EXAMPLES
.TP
To use w3m as a pager:
.br
$ ls | w3m
.br
.TP
To use w3m to translate HTML files:
.br
$ cat foo.html | w3m -T text/html
.TP
or
.br
$ cat foo.html | w3m -dump -T text/html >foo.txt
.SH FILES
.TP
.I ${HOME}/.w3m/config
configuration file
.TP
.I ${HOME}/.w3m/keymap
key binding configuration file
.\" .TP
.\" .I ${HOME}/.w3m/menu
.\" ???
.TP
.I ${HOME}/.w3m/mouse
mouse configuration file
.TP
.I ${HOME}/.w3m/cookie
cookie file
.TP
.I ${HOME}/.w3m/history
history file
.TP
.I ${HOME}/.w3m/passwd
passowrd and username file
.TP
.I ${HOME}/.w3m/pre_form
form parameters file
.TP
.I ${HOME}/.w3m/mailcap
external viewer configuration file
.TP
.I ${HOME}/.w3m/mime.types
MIME types file
.\" .TP
.\" .I ${HOME}/.w3m/urimethodmap
.\" ???
.SH NOTES
This is the
.I
w3m
0.5.3 Release.
.PP
Please see the MANUAL.html file distributed with w3m for
more detailed documentation.

Additional information about
.I
w3m
may be found on its Japanese language Web site located at:
  http://w3m.sourceforge.net/index.ja.html
.br
or on its English version of the site at:
  http://w3m.sourceforge.net/index.en.html
.SH ACKNOWLEDGMENTS
.I
w3m
has incorporated code from several sources.
Users have contributed patches and suggestions over time.
.SH AUTHOR
Akinori ITO <aito@fw.ipsj.or.jp>