.SH SYNOPSIS
.B mothra
[
+.B -va
+]
+[
.B -m
.I mtpt
] [
]
.SH DESCRIPTION
.I Mothra
-retrieves and displays files from the World-Wide Web,
+uses
+.IR webfs (4)
+to retrieve and display files from the World-Wide Web,
by name or through hypertext links.
Web names, called URLs, have a peculiar syntax:
.IP
.EX
-http://netlib.att.com/netlib/1127/www/1127.html
-http://akebono.stanford.edu:80/yahoo/
-http://www.teleport.com/~crowell/
-ftp://ftp.gmd.de/music/scores/harrington/Harrington.readme
+http://9front.org/
+https://code.9front.org/plan9front/
+http://cat-v.org/
.EE
.PP
The part up to the first colon gives the protocol for
.BR http: ,
Hyper-Text Transfer
Protocol, is the usual way of accessing web files.
-.B ftp:
-and
-.B gopher:
-are standard Internet services.
.PD
.PP
.B //
.PP
There are a number of options:
.TP
-.B -d
-Debug mode.
+.B -a
+Alt display. Starts in alt display mode, see menu
+commands table below.
.TP
-.B -v
-Verbose mode. Causes HTML errors to appear in
-.B $home/lib/mothra/mothra.err
-.PP
-Mothra uses
+.B -m
+Specify the
.IR webfs (4)
-to retrive the url data. The mountpoint, default is
-.B /mnt/web,
-can be changed with the
-.BR -b
-.I mtpt .
+mountpoint with
+.BR -m
+.I mtpt.
+The default is
+.B /mnt/web.
+.TP
+.B -v
+Verbose mode. Causes HTML errors to be printed
+on file-descriptor 2.
.PP
The display contains the last message from
.I mothra,
.B alt display
Collapse or expand the navigation boxes at the top of the browser window.
.TP
-.B snarf url
-Copy the current URL to the snarf buffer.
+.B moth mode
+Enter moth mode and switch to the moth cursor. If the HREF of an image
+link is different from the URL of the image itself, a link to the HREF will be
+printed on the right side of the image. Clicking an image or link with mouse
+button 1 prompts the user to save a copy of the file in the current directory.
+Clicking mouse button 2 sets the target as the current URL.
+Clicking the
+.B moth mode
+menu option again exits moth mode.
+.TP
+.B snarf
+Copy the current entry text or selected page text to snarf buffer.
+If nothing is selected, the current URL is copied.
.TP
.B paste
-Paste the current snarf buffer at the current cursor position.
+Paste the snarf buffer to the current text entry.
+.TP
+.B search
+Search for a regular expression in the current page.
.TP
.B save hit
Save the current URL to the hit list.
.TF typed\ commands
.TP
.B a
-Collapse or expand the navigation boxes at the top of the browser window.
+Toggle alt display.
.TP
.BI g " url
-Get the page with the given URL.
+Go to the page with the given URL.
.TP
.BI j " n
Jump to page
.I n
from the list of previously viewed pages.
.TP
+.BI k
+Kill images on the current page.
+.TP
+.BI m
+Enter or exit moth mode.
+.TP
.B r
Reload the current page.
.TP
.PP
When
.I mothra
-retrieves a file that is not an
+retrieves a direct link to a file that is not an
HTML document (for example a GIF or JPEG
image), it will start up an appropriate viewer, for example
-.B fb/9v
+.B page
(see
-.IR 9v (9.1))
-for image files.
+.IR page (1))
+for most image files.
.SH FILES
.B $home/lib/mothra/hit.html
the hit list
-.br
-.B $home/lib/mothra/mothra.url
-log of visited URLs
-.br
-.B $home/lib/mothra/mothra.err
-log of error messages, including HTML syntax errors
.SH SOURCE
.B /sys/src/cmd/mothra
.SH "SEE ALSO"
Files are saved in the form received,
not in the form suggested by the name in an
.B s
-command.
-.br
+command. A directory index saved from moth mode may be written in
+the local directory as a file named
+.B index.
+Sanitizing remote file names for the local file system is imperfect.
+.PP
+.I Mothra
+is distributed in a preliminary state; it has more than its share of bugs. Note that
+.I mothra,
+like the other Guardian Monsters, has no particular concern for humanity.
+.SH HISTORY
.I Mothra
-is distributed in a preliminary state; it has more than its share of bugs.
+first appeared in Plan 9 from Bell Labs (1995). It was later modified for inclusion in
+9front (September, 2011).