/usr/share/doc/stilts/sun256/votlint-usage.html is in stilts-doc 3.1.2-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Usage</title>
</head>
<body>
<hr>
<a href="secB.39.2.html">Next</a> <a href="votlint.html">Previous</a> <a href="votlint.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="secB.39.2.html">Items Checked</a><br>
<b>Up: </b><a href="votlint.html">votlint: Validates VOTable documents</a><br>
<b>Previous: </b><a href="votlint.html">votlint: Validates VOTable documents</a><br>
<hr>
<h3><a name="votlint-usage">B.39.1 Usage</a></h3>
<p>The usage of <code>votlint</code> is
<pre>
stilts <stilts-flags> votlint validate=true|false version=1.0|1.1|1.2|1.3
out=<location>
[votable=]<location>
</pre>
If you don't have the <code>stilts</code> script installed,
write "<code>java -jar stilts.jar</code>" instead of
"<code>stilts</code>" - see <a href="invoke.html">Section 3</a>.
The available <code><stilts-flags></code> are listed
in <a href="stilts-flags.html">Section 2.1</a>.
For programmatic invocation, the Task class for this
command is <code>uk.ac.starlink.ttools.task.VotLint</code>.
</p>
<p>Parameter values are assigned on the command line
as explained in <a href="task-args.html">Section 2.3</a>.
They are as follows:
</p>
<p>
<dl>
<dt><strong><code>out = <location></code> <em>(uk.ac.starlink.util.Destination)</em></strong></dt>
<dd>Destination file for output messages.
May be a filename or "-" to indicate standard output.
<p>[Default: <code>-</code>]
</p>
</dd>
<dt><strong><code>validate = true|false</code> <em>(Boolean)</em></strong></dt>
<dd>Whether to validate the input document aganist
the VOTable DTD.
If true (the default), then as well as
<code>votlint</code>'s own checks,
it is validated against an appropriate version of the VOTable
DTD which picks up such things as the presence of
unknown elements and attributes, elements in the wrong place,
and so on.
Sometimes however, particularly when XML namespaces are
involved, the validator can get confused and may produce
a lot of spurious errors. Setting this flag false prevents
this validation step so that only <code>votlint</code>'s
own checks are performed.
In this case many violations of the VOTable standard
concerning document structure will go unnoticed.
<p>[Default: <code>true</code>]
</p>
</dd>
<dt><strong><code>version = 1.0|1.1|1.2|1.3</code> <em>(uk.ac.starlink.votable.VOTableVersion)</em></strong></dt>
<dd>Selects the version of the VOTable standard which the input
table is supposed to exemplify.
The version may also be specified within the document
using the "version" attribute of the document's VOTABLE
element; if it is and it conflicts with the value specified
by this flag, a warning is issued.
<p>If no value is provided for this parameter (the default),
the version will be determined from the VOTable itself.
</p>
</dd>
<dt><strong><code>votable = <location></code> <em>(<a href="http://docs.oracle.com/javase/6/docs/api/java/io/InputStream.html">InputStream</a>)</em></strong></dt>
<dd>Location of the VOTable to be checked.
This may be a filename, URL or "-" (the default),
to indicate standard input.
The input may be compressed using one of the known
compression formats (Unix compress, gzip or bzip2).
<p>[Default: <code>-</code>]
</p>
</dd>
</dl>
</p>
<hr><a href="secB.39.2.html">Next</a> <a href="votlint.html">Previous</a> <a href="votlint.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="secB.39.2.html">Items Checked</a><br>
<b>Up: </b><a href="votlint.html">votlint: Validates VOTable documents</a><br>
<b>Previous: </b><a href="votlint.html">votlint: Validates VOTable documents</a><br>
<hr><i>STILTS - Starlink Tables Infrastructure Library Tool Set<br>Starlink User Note256<br>STILTS web page:
<a href="http://www.starlink.ac.uk/stilts/">http://www.starlink.ac.uk/stilts/</a><br>Author email:
<a href="mailto:m.b.taylor@bristol.ac.uk">m.b.taylor@bristol.ac.uk</a><br>Mailing list:
<a href="mailto:topcat-user@jiscmail.ac.uk">topcat-user@jiscmail.ac.uk</a><br></i></body>
</html>
|