next up previous
Next: How Catalogue Files are Searched
Up: CATALOGUE FILES
Previous: Catalogue File Name and Format

 A Catalogue File Example

Suppose, for example, that you are converting an existing documentation set into hypertext form, but still have some documents available only in DVI and postscript format (with file extensions ".dvi" and ".ps"). The findme command will not be able to search these "old" documents because it doesn't know how to extract (for example) their titles from the files provided. To help overcome this, you would describe these documents in a catalogue file, perhaps along the following lines:

review doc1.ps A Review of Documentation Systems
intro doc2.dvi Introduction to Hypertext
writing writing.ps How to Communicate Effectively
...

Note that the document name and file name need not match. This file introduces the listed documents to the findme command, tells it where to find the corresponding document files and allows it to perform searching by document name and/or title (but not by page heading or lines of textual content, since it cannot know how to decode the document format to obtain these).



next up previous
Next: How Catalogue Files are Searched
Up: CATALOGUE FILES
Previous: Catalogue File Name and Format



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