3 mothra \- retrieve and display World-Wide Web files
19 to retrieve and display files from the World-Wide Web,
20 by name or through hypertext links.
21 Web names, called URLs, have a peculiar syntax:
25 https://code.9front.org/hg/plan9front/
29 The part up to the first colon gives the protocol for
33 Protocol, is the usual way of accessing web files.
37 begins the Internet address of the server where the file resides.
38 The address may contain a colon and a TCP port
39 number, which overrides the
40 default port number for the service. Next comes a
41 file name. Finally, the file name may be followed by
43 and a string giving a label within the file where the
49 given on the command line, defaulting to
50 the environment variable
53 There are a number of options:
56 Alt display. Starts in alt display mode, see menu
69 Verbose mode. Causes HTML errors to be printed
72 The display contains the last message from
74 a box where typed commands appear,
75 a scrollable list of previously visited files,
76 the title and URL of the current file,
77 and the scrollable text of the current file.
79 Button 1 selects and displays a file, either from the list
80 of previously visited pages or from a link (indicated
81 by underlined text or a boxed image) in the
82 current file. Button 2 shows the URL of a file,
83 but does not retrieve or display it.
84 Button 3 pops up a menu of commands:
88 Collapse or expand the navigation boxes at the top of the browser window.
91 Enter moth mode and switch to the moth cursor. If the HREF of an image
92 link is different from the URL of the image itself, a link to the HREF will be
93 printed on the right side of the image. Clicking an image or link with mouse
94 button 1 prompts the user to save a copy of the file in the current directory.
95 Clicking mouse button 2 sets the target as the current URL.
98 menu option again exits moth mode.
101 Copy the current entry text or selected page text to snarf buffer.
102 If nothing is selected, the current URL is copied.
105 Paste the snarf buffer to the current text entry.
108 Search for a regular expression in the current page.
111 Save the current URL to the hit list.
114 Retrieve and display the hit list.
117 Ask for confirmation and quit.
120 The typed commands are:
127 Go to the page with the given URL.
132 from the list of previously viewed pages.
135 Kill images on the current page.
138 Enter or exit moth mode.
141 Reload the current page.
144 Save the current page in the given
148 Capture a screenshot of the entire browser window in the given
152 Capture a screenshot of the content area in the given
161 retrieves a direct link to a file that is not an
162 HTML document (for example a GIF or JPEG
163 image), it will start up an appropriate viewer, for example
167 for most image files.
169 .B $home/lib/mothra/hit.html
172 .B /sys/src/cmd/mothra
176 Files are saved in the form received,
177 not in the form suggested by the name in an
179 command. A directory index saved from moth mode may be written in
180 the local directory as a file named
182 Sanitizing remote file names for the local file system is imperfect.
185 is distributed in a preliminary state; it has more than its share of bugs. Note that
187 like the other Guardian Monsters, has no particular concern for humanity.
190 first appeared in Plan 9 from Bell Labs (1995). It was later modified for inclusion in
191 9front (September, 2011).