The basic usage of votcopy
is
votcopy [<flags>] [<in-file> [<out-file>]]If you don't have the Unix scripts installed, invoke it as described in Section 2 using the classname
uk.ac.starlink.ttools.VotCopy
.
If <out-file>
is omitted the result is written to
standard output, and if <in-file>
is also omitted
the document to be copied is read from standard input.
<in-file>
may be a filename or URL, and may
represent a VOTable compressed using one of the supported
compression formats (gzip, Unix compress and bzip2).
The flags, which may be given in any order, are as follows:
-f[ormat] tabledata|binary|fits|none
none
is selected, then the tables will
be data-less (contain no DATA
element), leaving only
the document structure. Data-less tables are legal VOTable elements.
-href
STREAM
elements
will contain their data inline or externally.
If -href
is not specified, the output document will
be self-contained, with STREAM
data inline as base64-encoded
characters. If -href
is specified, then for each
table in the document the binary data will be written to a separate
file and referenced by a href
attribute on the
corresponding STREAM
element.
The name of these files is usually determined by the name of the
main output file; but see also the -base
flag.
-base <name>
-href
flag is specified. Normally these are given
names based on the name of the output file.
But if -base <name>
is given, then these will given a name based on <name>
.
The -base
flag is compulsory if -href
is
given and no output file is specified (output is to standard out),
since in this case there is no default base name to use.
-cache
votcopy
without the
-cache
flag when it is required,
an error message will tell you so.
-disk
-cache
is
specified, and only required for large tables.
Equivalent to setting the system property
-Dstartable.storage=disk
.
-encode <xml-encoding>
-debug
-h[elp]