W3C LMB MANUAL

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:

	z <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.
manual
Jumps directly to the master document of the online manual.
verbose
Toggles verbose mode (for maintenance purposes)
which
Shows the title and location of the current document

Getting around in a document

<return>
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

<number>
Typing a number by itself follows the corresponding reference from the currently displayed document.
back
Goes back to the document you were reading before.
forward
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.
home
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

options
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
Put the current document to a remote HTTP server using the PUT method.
	put
	Destination: http://www.my.server
post
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.

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

Killer Features

clear
Clears the history list
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
Refresh the screen but does not cause freshness validation of any kind
source
Followed by another command, causes raw source to be generated for that command but without any MIME headers wrapped around it.

Persistent Cache Management

flush
Flushes the persistent cache by deleting all entries on disk
validate
Validates the current document with the nearest cache or at the origin server
revalidate
End-validates the current document by forcing validation of all caches and at the origin server
reload
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:

print
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 $