merge

[plan9front.git] / sys / man / 1 / mothra

diff --git a/sys/man/1/mothra b/sys/man/1/mothra
index 71a7e1eca60b1d6c84ecd10afa652b4a4adaf65b..d9f5c480c96a3a5880c5820ef94c1cde02818721 100644 (file)
--- a/sys/man/1/mothra
+++ b/sys/man/1/mothra
@@ -4,7 +4,7 @@ mothra \- retrieve and display World-Wide Web files
 .SH SYNOPSIS
 .B mothra
 [
-.B -dv
+.B -va
 ]
 [
 .B -m
@@ -21,10 +21,9 @@ 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/hg/plan9front/
+http://cat-v.org/
 .EE
 .PP
 The part up to the first colon gives the protocol for
@@ -32,10 +31,6 @@ retrieving the file.
 .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 //
@@ -57,8 +52,12 @@ the environment variable
 .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 -k
+Kill images. Don't fetch/display images.
 .TP
 .B -m
 Specify the
@@ -70,8 +69,8 @@ The default is
 .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,
@@ -95,17 +94,21 @@ Collapse or expand the navigation boxes at the top of the browser window.
 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.
@@ -121,16 +124,19 @@ The typed commands are:
 .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
+Toggle killing of images.
+.TP
 .BI m
 Enter or exit moth mode.
 .TP
@@ -155,7 +161,7 @@ Quit.
 .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
@@ -165,12 +171,6 @@ 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"
@@ -188,3 +188,7 @@ Sanitizing remote file names for the local file system is imperfect.
 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).