There are two ways of invoking the commands in this package.
If you're using a Unix-like operating system and have downloaded
the package in a form which includes the shell scripts,
the easiest way is to use the scripts tpipe
,
votlint
etc. These will either be in the same location
as the stilts.jar
file or in starjava/bin
The form of invocation in this case is:
<command-name> <java-args> <application-args>(the
java
should be on your path).
A simple example would be:
votcopy -f binary t1.xml t2.xmlFor convenience you can mix up java-args and application-args - the script will untangle them and reorder them properly. If you use the
-classpath
argument or have a CLASSPATH environment variable set,
then classpath elements thus specified will be added to the classpath
required to run the command.
The examples in the
command descriptions below use this form for convenience.
If you don't have a Unix-like shell available however, or if you don't have the STILTS shell scripts, you will need to invoke Java directly with the appropriate classes on your classpath. The general form of an invocation command in this case will depend on your system, but will probably look like:
java <java-args> -classpath <command-classpath> <command-classname> <application-args>The example above in this case would look something like:
java -classpath some/where/stilts.jar uk.ac.starlink.table.VotCopy -f binary t1.xml t2.xml
More detail is given on the parts of these command lines in the following subsections.