file: QUICKSTART		G. Moody		3 April 2001
				Last revised:	      10 October 2002
Using `plt'
==========

If you haven't compiled and installed `plt' yet, follow the instructions
in `INSTALL'.  The last step of the installation is to run a demonstration
of `plt', which will show you a wide variety of example plots.

Look at the shell scripts `xdemo.sh' and `psdemo.sh' (in the `doc' directory)
to see how the example plots are created, and follow these examples.

`plt' has a vast number of options.  You can always get a one-line summary of
each of them by running the command:
    plt -h
If one or more strings (which should not begin with `-') follow the `-h', `plt'
prints summaries for the options beginning with those strings only.  For
example,
    plt -h x y
shows all of the options whose names begin with `x' or `y'.

Under Unix or Linux, it is usually most convenient to preview your plots on the
X11 display before printing them.  The simplest way to do this is to run your
`plt' command without a `-T' option; to print, just rerun the same command, but
add `-T lw' to the `plt' argument list, and pipe the output to `lwcat'.  For
example:
    plt xxx ...			(to preview the plot in an X window)
    plt -T lw xxx ... | lwcat	(to print the same plot on the printer)

Under MS-Windows, if you have installed XFree86 and you have started the
X server, follow the same instructions as for Unix or Linux.  Otherwise, set
the TERM variable to `cygwin' (this is done automatically if you are using
the Cygwin terminal emulator).  Unless the X server is running, all `plt'
output must be piped to `lwcat' for viewing or printing:
    plt xxx ... | lwcat		(to preview the plot in a GSView window; use
				the GSView controls to print it if desired)

More information
================

The file `book.ps', in the `doc' directory, is the `plt Tutorial and Cookbook'.
Read the `plt Tutorial and Cookbook' to see how the example plots were
constructed, and to learn about the most effective ways to use `plt' with your
own data.  Open `doc/book.ps' using `gv' (Ghostview, under Unix or Linux) or
GSView (under MS-Windows); these programs (available freely from
http://ghostscript.com/) allow you to view the book on-screen, or to print all
or part of it on a wide variety of printers.  If you have a PostScript printer,
you can also print `doc/book.ps' directly without using `gv', etc.

The `doc' directory also contains the data and format files used to create
the examples, the LaTeX source for the `plt Tutorial and Cookbook', and a
few more examples not included in the book.
