next up previous
Next: Displaying Parts of Documents by Label
Up: GAINING ACCESS TO DOCUMENTS
Previous: GAINING ACCESS TO DOCUMENTS

  Displaying Documents by Name

The simplest form of document access is provided by the showme command, which simply displays the document you name. For instance:

showme sun188

would display the "top" page of the document called "sun188" (i.e. the one you are reading now). Using this command is normally easier than entering a full URL for the document.

The showme command displays the document using a WWW browser and will make use of one you already have running if possible. You can specify which browser to use, if required.

If you do not give any directory information, showme will search for the document using the HTX_PATH search path, but you can specify explicitly where the document is if you prefer, as in:

showme ~/mydocs/galaxy_survey

If showme cannot find the document locally, it will try and fetch it from the remote document server instead. You can suppress this behavior using the -l switch if you prefer:

showme -l document

in which case failure to find the document locally will simply result in an error. You can also specify that a remote copy of the document is required using the -r switch, in which case any local copy will be ignored and the remote document server will be asked to supply the document.



next up previous
Next: Displaying Parts of Documents by Label
Up: GAINING ACCESS TO DOCUMENTS
Previous: GAINING ACCESS TO DOCUMENTS



HTX Hypertext Cross-Reference Utilities
Starlink User Note 188
R.F. Warren-Smith
6th January 1998
E-mail:rfws@star.rl.ac.uk