.SH SYNOPSIS
.B mothra
[
-.B -dv
+.B -va
]
[
.B -m
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 -m
Specify the
.B /mnt/web.
.TP
.B -v
-Verbose mode. Causes HTML errors to appear in
-.B $home/lib/mothra/mothra.err
+Verbose mode. Causes HTML errors to be printed
+on file-descriptor 2.
.PP
The display contains the last message from
.I mothra,
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 saves a copy of the file in the current directory. Clicking mouse
-button 2 sets the target as the current URL.
+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 url
-Copy the current URL to the snarf buffer.
+.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
.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 page
.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"
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
+first appeared in Plan 9 from Bell Labs (1995). It was later modified for inclusion in
+9front (September, 2011).