ref: 63f93b3b0dbf496beeb97dd7c97693d351da3f8f
parent: 39ed950d6fb8ac2660e9e30052f4d838a3599e53
author: cinap_lenrek <cinap_lenrek@centraldogma>
date: Sun Sep 4 23:55:47 EDT 2011
mothra(1) manpage
--- /dev/null
+++ b/sys/man/1/mothra
@@ -1,0 +1,139 @@
+.TH MOTHRA 1
+.SH NAME
+mothra \- retrieve World-Wide Web files
+.SH SYNOPSIS
+.B mothra
+[
+.B -m
+.I mtpt
+] [
+.I url
+]
+.SH DESCRIPTION
+.I Mothra
+retrieves and displays 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
+.EE
+.PP
+The part up to the first colon gives the protocol for
+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 //
+begins the Internet address of the server where the file resides.
+The address may contain a colon and a TCP port
+number, which overrides the
+default port number for the service. Next comes a
+file name. Finally, the file name may be followed by
+.B #
+and a string giving a label within the file where the
+display should begin.
+.PP
+.I Mothra
+starts with the
+.I url
+given on the command line, defaulting to
+the environment variable
+.BR $url .
+.PP
+Mothra uses
+.IR webfs (4)
+to retrive the url data. The mountpoint, default is
+.B /mnt/web,
+can be changed with the
+.BR -b
+.I mtpt .
+.PP
+The display contains the last message from
+.I mothra,
+a box where typed commands appear,
+a scrollable list of previously visited files,
+the title and URL of the current file,
+and the scrollable text of the current file.
+.PP
+Button 1 selects and displays a file, either from the list
+of previously visited pages or from a link (indicated
+by underlined text or a boxed image) in the
+current file. Button 2 shows the URL of a file,
+but does not retrieve or display it.
+Button 3 pops up a menu of commands:
+.TF save\ back
+.TP
+.B save back
+Place a link to the current file in a `back list'
+for future reference.
+.TP
+.B get back
+Retrieve and display the back list.
+.TP
+.B fix cmap
+Adjust the display's color map so that images will
+have correct colors.
+.TP
+.B exit
+Ask for confirmation and quit.
+.PD
+.PP
+The typed commands are:
+.TF save\ back
+.TP
+.BI g " url
+Get the page with the given URL.
+.TP
+.BI s " file
+Save the current file in the given
+.I file.
+.TP
+.B q
+Quit.
+.TP
+.B ?
+.TP
+.B h
+Get help.
+.PD
+.PP
+When
+.I mothra
+retrieves 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
+(see
+.IR 9v (9.1))
+for image files.
+.SH FILES
+.B $home/lib/mothra/back.html
+the back 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"
+.IR webfs (4)
+.SH BUGS
+Files are saved in the form received,
+not in the form suggested by the name in an
+.B s
+command.
+.br
+.I Mothra
+is distributed in a preliminary state; it has more than its share of bugs.