Directory Structure

In this documentation, VMS file names have been used. It is a simple matter to map VMS file names to UNIX or DOS names. A file name of XANADU:[LIB.PLT]PLT.FOR implies that the file PLT.FOR is on the XANADU disk, in the PLT sub-directory of a main directory called LIB. For example, on a Unix system, the above file would be called /xanadu/lib/plt/plt.for. For ease of sharing XANADU files with systems that are not case sensitive, only lower case file names are allowed under Unix. On an MS-DOS system, XANADU should be the top level directory on your default hard disk; so our sample file would be called \XANADU\LIB\PLT\PLT.FOR. An attempt should be made to preserve this type of organization on other systems.

The following directories of the XANADU virtual disk contain files needed by the QDP/PLT software:

XANADU:[BIN]

contains the executable versions of both COD and QDP.

XANADU:[LIB]

contains the XANLIB object library.

XANADU:[LIB.COD]

contains a set of sample COD files.

XANADU:[LIB.PLT]

contains the source code for the PLT subroutine and for other supporting routines.

XANADU:[LIB.TERMIO]

contains the source code for the low level terminal IO routines.

XANADU:[LIB.UFNY]

contains the source code for the demo user function. On VMS systems UFNY.FOR should NOT be installed into the XANLIB library, but rather the sharable library used instead.

XANADU:[LIB.XANLIB]

contains the system dependent routines. Currently, there is a SYS.VMS should be used on VAX VMS systems, SYS.SUN on SUN UNIX systems, and SYS.NEX on NeXT NeXTStep systems.

XANADU:[LIB.XCOMS]

This directory contains the system-wide indirect command files. For example, the file HARD.PCO should create a hardcopy file and then queue the file to the printer.

XANADU:[LIB.XHELP]

contains the source code for the interactive help.

XANADU:[LIB.XPARSE]

contains the XSPEC parser routines. Currently the following files are required from this directory: IXPLWR.FOR, XCHKBL.FOR, XCHKDL.FOR, XCHOSE.FOR, XCREAD.FOR, XGTARG.FOR, XMATCH.FOR, XQMTCH.FOR, XQUEST.FOR, XSQUEZ.FOR, XUNIDS.FOR, and the include file XPARINC.INC.

XANADU:[PLOT.QDP]

contains the source code for the COD and QDP programs, the interactive help files, and the demonstration QDP files.

XANADU:[PLOT.QDP.MANUAL]

contains the source listings of this manual in LaTeX format. To print the manual, you will need to issue the command LATEX QDP twice, to ensure that the table of contents is correct.

XANADU:[SRC.DOC]

contains the source code for the system level help programs. These are not needed to run the QDP/PLT software, but are useful when creating the help libraries.