Running the Tcl Demos.

Note these directions as well as taking proper care of all the
dependencies have been incorporated into our CMake-based build systems
for the core build and the installed examples build.  So the tests
below of the Tcl component of PLplot can be done by simply running

make test_interactive

However, we preserve the directions below for historical reasons and
in case you want to do any of these commands by hand, e.g., with
valgrind.

There are two ways to run the examples below, where the alternatives
are indicated by "|".  The first alternative should only be used if
you have changed directories to
$prefix/share/plplot$VERSION/examples/tcl where $prefix is the PLplot
install prefix and $VERSION is the PLplot release version, e.g.,
5.9.10.  That is, the first alternative should be used if you have
changed directories to the installed examples/tcl directory.  The
second alternative should only be used if you have changed directories
to bindings/examples/ttcl in the build tree.

To run individual examples, run the x?? script corresponding to the x??.tcl
example, where ?? is 00 through 33 (except for 32), e.g.,

./x00 -dev xwin |  env PATH=../../bindings/tcl:$PATH ./x00 -dev xwin

Note, -dev xwin is just one possible PLplot driver, and there are many others.

To find out all the possible command-line
options run pltcl -h or x?? -h (every x?? script runs pltcl).

To run the plot.tcl demo follow the directions in that file to run it
under pltcl with the various standard devices.

To run the plgrid.tcl demo follow the directions in that file to run it
under pltcl with the various standard devices.

tcldemos.tcl runs all the standard examples except for example 32.

There are two ways to run tcldemos.tcl:

(1)
pltcl | ../../bindings/tcl/pltcl
plinit
source tcldemos.tcl
0
1
2
....
plend
exit

Note the pltcl command has normal PLplot command-line options (run pltcl -h
to find out what they are).  In fact, you can specify, e.g., -dev tk or
-dev xwin, but since plinit has to be run in any case, you might as
well use the device driver chooser in that case.

(2) Note, fill in $prefix below with whatever you configured for the install
prefix (/usr/local/plplot or whatever) and $VERSION with the plplot VERSION
you are running at this time (5.11.0 or whatever).

tclsh
lappend auto_path $prefix/share/plplot$VERSION | ../../bindings/tcl
package require Pltcl
plinit
source tcldemos.tcl
0
1
2
....
plend
exit

To find out more about the tclsh command (which comes as part of the tcl
package) use man tclsh.

Both the pltcl and tclsh methods execute the various x??.tcl examples
corresponding to the numbers (in the range from 0 to 33, except for 32)
specified by the user.

Test the matrix capabilities of the tclmatrix library.

pltcl | ../../bindings/tcl/pltcl
source <top of source tree>/bindings/tcl/test_tclmatrix.tcl
ctrl-D to exit pltcl

Copy complete output from the above and compare (e.g., with diff) with the
file <top of source tree>/bindings/tcl/test_tclmatrix.out which contains
the results that should be generated above if the tclmatrix library
is working properly on your platform.
