![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to mothra CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Plan 9 NeXT] / lucent / sys / man / 1|
Return to mothra CVS log | Up to [Plan 9 NeXT] / lucent / sys / man / 1 |
1.1 root 1: .TH MOTHRA 1
2: .SH NAME
3: mothra \- retrieve World-Wide Web files
4: .SH SYNOPSIS
5: .B mothra
6: [
7: .I url
8: ]
9: .SH DESCRIPTION
10: .I Mothra
11: retrieves and displays files from the World-Wide Web,
12: by name or through hypertext links.
13: Web names, called URLs, have a peculiar syntax:
14: .IP
15: .EX
16: http://netlib.att.com/netlib/1127/www/1127.html
17: http://akebono.stanford.edu:80/yahoo/
18: http://www.teleport.com/~crowell/
19: file:/sys/lib/mothra/help.html
20: file:html2.elements.html#ADDRESS
21: ftp://ftp.gmd.de/music/scores/harrington/Harrington.readme
22: gopher://gopher.bev.net/11/BevBus/King.Video
23: .EE
24: .PP
25: The part up to the first colon gives the protocol for
26: retrieving the file.
27: .BR http: ,
28: Hyper-Text Transfer
29: Protocol, is the usual way of accessing web files.
30: .B file:
31: names a file in the local file system.
32: .B ftp:
33: and
34: .B gopher:
35: are standard Internet services.
36: .PD
37: .PP
38: .B //
39: begins the Internet address of the server where the file resides.
40: The address may contain a colon and a TCP port
41: number, which overrides the
42: default port number for the service. Next comes a
43: file name. Finally, the file name may be followed by
44: .B #
45: and a string giving a label within the file where the
46: display should begin.
47: .PP
48: .I Mothra
49: starts with the
50: .I url
51: given on the command line, defaulting to
52: the environment variable
53: .BR $url ,
54: and finally to
55: .BR file:/sys/lib/mothra/start.html .
56: .PP
57: The display contains the last message from
58: .I mothra,
59: a box where typed commands appear,
60: a scrollable list of previously visited files,
61: the title and URL of the current file,
62: and the scrollable text of the current file.
63: .PP
64: Button 1 selects and displays a file, either from the list
65: of previously visited pages or from a link (indicated
66: by underlined text or a boxed image) in the
67: current file. Button 2 shows the URL of a file,
68: but does not retrieve or display it.
69: Button 3 pops up a menu of commands:
70: .TF save\ back
71: .TP
72: .B save back
73: Place a link to the current file in a `back list'
74: for future reference.
75: .TP
76: .B get back
77: Retrieve and display the back list.
78: .TP
79: .B fix cmap
80: Adjust the display's color map so that images will
81: have correct colors.
82: .TP
83: .B exit
84: Ask for confirmation and quit.
85: .PD
86: .PP
87: The typed commands are:
88: .TF save\ back
89: .TP
90: .BI g " url
91: Get the page with the given URL.
92: .TP
93: .BI s " file
94: Save the current file in the given
95: .I file.
96: .TP
97: .B q
98: Quit.
99: .TP
100: .B ?
101: .TP
102: .B h
103: Get help.
104: .PD
105: .PP
106: When
107: .I mothra
108: retrieves a file that is not an
109: HTML document (for example a GIF or JPEG
110: image), it will start up an appropriate viewer, for example
111: .B fb/9v
112: (see
113: .IR 9v (9.1))
114: for image files.
115: .SH FILES
116: .B /sys/lib/mothra/*
117: .br
118: .B $home/lib/mothra/back.html
119: the back list
120: .br
121: .B $home/lib/mothra/mothra.url
122: log of visited URLs
123: .br
124: .B $home/lib/mothra/mothra.err
125: log of error messages, including HTML syntax errors
126: .SH SOURCE
127: .B /sys/src/cmd/mothra
128: .SH BUGS
129: .B ftp:
130: URLs are not supported.
131: .br
132: Files are saved in the form received,
133: not in the form suggested by the name in an
134: .B s
135: command.
136: .br
137: .I Mothra
138: is distributed in a preliminary state; it has more than its share of bugs.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.