diff options
author | cinap_lenrek <cinap_lenrek@centraldogma> | 2011-09-05 03:55:47 +0200 |
---|---|---|
committer | cinap_lenrek <cinap_lenrek@centraldogma> | 2011-09-05 03:55:47 +0200 |
commit | 63f93b3b0dbf496beeb97dd7c97693d351da3f8f (patch) | |
tree | 28a7ae61d714a8004addb8c2e2f858e216f96111 /sys/man/1/mothra | |
parent | 39ed950d6fb8ac2660e9e30052f4d838a3599e53 (diff) |
mothra(1) manpage
Diffstat (limited to 'sys/man/1/mothra')
-rw-r--r-- | sys/man/1/mothra | 139 |
1 files changed, 139 insertions, 0 deletions
diff --git a/sys/man/1/mothra b/sys/man/1/mothra new file mode 100644 index 000000000..374bd9b89 --- /dev/null +++ b/sys/man/1/mothra @@ -0,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. |