Line Mode Browser Commands

The following commands are available at the prompt within WWW Line Mode Browser when used in interactive mode. Not all of them are applicable at all times, but the online help shows which commands can be used at a particular moment. All commands may be abbreviated and case is not significant. As an example, you can type "put" as:

	pu, put, Put, PUT, etc.

If the browser is run in "multi threaded" mode, then you can type in a new command at all times. You do not have to wait until a command is terminated. All requests can be interrupted by hitting 'z' (or 'Z') and then return:


When run in single threaded mode using the -single command line option, it is not possible to interrupt a request.

Getting Help and Information

help, ?
Gives a list of available commands depending on the context, the version number of the www program, and the hypertext address, (or URL) of the document you are reading.
Jumps directly to the master document of the online manual.
Toggles verbose mode (for maintenance purposes)
Shows the title and location of the current document

Getting around in a document

Just hitting Return displays the next page (if any) of the current document.
top, bottom
Goes to the top or the bottom of the current document
up, down
Scrolls up or down one page in the current document.

Load a Document

Typing a number by itself follows the corresponding reference from the currently displayed document.
Goes back to the document you were reading before.
Goes to the next document in the history list if any.
goto <address>
Goes to the document represented by the given hypertext address, which is interpreted relatively to the current document.
Goes back to the first document you were reading.

Search a Document

find, keyword <keywords>
Queries the current index with the supplied keywords (separated by blanks). The interpretation of the keywords depends on the particular information server you're looking at. In most cases, it will search a database for entries matching the keywords, and will display the results with possibly links to further details. For more complex queries, instructions should be present in the cover page. The "Find" (or "Keywords") command can be omitted if the first keyword does not conflict with another www command.

Find out information about a Document

Issues a request on the current document using the HTTP OPTIONS method.

Upload a Document to a remote server

In version 3.1 and later of the Line Mode Browser you can send a document to a remote HTTP server using PUT or POST.

Put the current document to a remote HTTP server using the PUT method.
	Destination: http://www.my.server
Post the current document to a remote HTTP server using the POST method. The syntax is the same as for PUT.

Delete a Document on a remote server

You can also use the DELETE method in the Line Mode browser to remove a document on a remote HTTP server.

Deletes the curent document on a remote HTTP server using the DELETE method.

Killer Features

Clears the history list
Gives a numbered list of the links from the current document, giving the title of the target documents if it is known otherwise the URL To follow a link, type the number by itself as above. By using source, only the URL's are displayed.
quit, exit
Leaves the application.
recall [ n ]
Without a parameter (n), "recall" gives a numbered list of the documents you have visited. To select one, type "recall" followed by the number.
Refresh the screen but does not cause freshness validation of any kind
Followed by another command, causes raw source to be generated for that command but without any MIME headers wrapped around it.

Persistent Cache Management

Flushes the persistent cache by deleting all entries on disk
Validates the current document with the nearest cache or at the origin server
End-validates the current document by forcing validation of all caches and at the origin server
Forces a full reload of the document regardless of whether the object might already be in either the memory cache or in the local file cache.

On Unix versions, the following extra commands are available:

Prints the current document, without the numbered document references. A background www is launched to do that, and its output is piped to the command defined by the environment variable WWW_PRINT_COMMAND ("lpr" by default). Can be used with source .
> <file>
Saves the current document to the given file, without the numbered document references. A background www is launched to do that. If the file exists, a ">!" will overwrite it. Can be used with source .
>> <file>
Appends the current document to the given file without the numbered links. Can be used with source.
| <command>
Pipes the current document to the given command, without the numbered document references. A background www is launched to do that. Can be used with source .
! <command>
Executes the given shell command without leaving www.
cd, lcd <directory>
Changes the local working directory. "! cd directory" won't do this because it applies to a subshell.

Tim BL, and Henrik Frystyk Nielsen, libwww@w3.org,

@(#) $Id: Commands.html,v 1.15 1996/12/09 03:25:56 jigsaw Exp $