path: root/doc/w3m.1



.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
Use "w3m -h" to display a complete list of current options.
.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 -s
Shift_JIS
.TP
.B -j
JIS
.TP
.B -e
EUC-JP
.TP
.B -B
load bookmark
.TP
.B -T type
specify content-type
.TP
.B -m
internet message mode
.TP
.B -M
monochrome display
.TP
.B -F
automatically render frame
.TP
.B -dump
dump formatted page into stdout
.TP
.B -cols width
specify column width (used with -dump)
.TP
.B -ppc count
specify the number of pixels per character (default 8.0)
Larger values will make tables narrower.
.TP
.B -dump_source
dump page source into stdout
.TP
.B +<num>
goto <num> line
.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 NOTES
This is the
.I
w3m
990604 Release.
.PP
Additional information about
.I
w3m
may be found on its Japanese language Web site located at:
  http://ei5nazha.yz.yamagata-u.ac.jp/~aito/w3m/
.br
or on its English version of the site at:
  http://ei5nazha.yz.yamagata-u.ac.jp/~aito/w3m/eng/
.SH ACKNOWLEDGMENTS
.I
w3m
has incorporated code from several sources.
Hans J. Boehm, Alan J. Demers, Xerox Corp. and Silicon Graphics
have the copyright of the GC library comes with w3m package.
Users have contributed patches and suggestions over time.
.SH AUTHOR
Akinori ITO <aito@ei5sun.yz.yamagata-u.ac.jp>
.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
Use "w3m -h" to display a complete list of current options.
.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 -s
Shift_JIS
.TP
.B -j
JIS
.TP
.B -e
EUC-JP
.TP
.B -B
load bookmark
.TP
.B -T type
specify content-type
.TP
.B -m
internet message mode
.TP
.B -M
monochrome display
.TP
.B -F
automatically render frame
.TP
.B -dump
dump formatted page into stdout
.TP
.B -cols width
specify column width (used with -dump)
.TP
.B -ppc count
specify the number of pixels per character (default 8.0)
Larger values will make tables narrower.
.TP
.B -dump_source
dump page source into stdout
.TP
.B +<num>
goto <num> line
.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 NOTES
This is the
.I
w3m
990604 Release.
.PP
Additional information about
.I
w3m
may be found on its Japanese language Web site located at:
  http://ei5nazha.yz.yamagata-u.ac.jp/~aito/w3m/
.br
or on its English version of the site at:
  http://ei5nazha.yz.yamagata-u.ac.jp/~aito/w3m/eng/
.SH ACKNOWLEDGMENTS
.I
w3m
has incorporated code from several sources.
Hans J. Boehm, Alan J. Demers, Xerox Corp. and Silicon Graphics
have the copyright of the GC library comes with w3m package.
Users have contributed patches and suggestions over time.
.SH AUTHOR
Akinori ITO <aito@ei5sun.yz.yamagata-u.ac.jp>