Return to mothra CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 1

Annotation of lucent/sys/man/1/mothra, revision 1.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.