/usr/share/doc/stilts/sun256/secB.39.3.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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Examples</title>
</head>
<body>
<hr>
<a href="secC.html">Next</a> <a href="secB.39.2.html">Previous</a> <a href="votlint.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="secC.html">Release Notes</a><br>
<b>Up: </b><a href="votlint.html">votlint: Validates VOTable documents</a><br>
<b>Previous: </b><a href="secB.39.2.html">Items Checked</a><br>
<hr>
<h3><a name="secB.39.3">B.39.3 Examples</a></h3>
<p>Here is a brief example of running <code>votlint</code> against
a (very short) imperfect VOTable document. If the document looks like
this:
<pre>
<VOTABLE version="1.1">
<RESOURCE>
<TABLE nrows="2">
<FIELD name="Identifier" datatype="char"/>
<FIELD name="RA" datatype="double"/>
<FIELD name="Dec" datatype="double"/>
<DESCRIPTION>A very small table</DESCRIPTION>
<DATA>
<TABLEDATA>
<TR>
<TD>Fomalhaut</TD>
<TD>344.48</TD>
<TD>-29.618</TD>
<TD>HD 216956</TD>
</TR>
</TABLEDATA>
</DATA>
</TABLE>
</RESOURCE>
</VOTABLE>
</pre>
then the output of a <code>votlint</code> run looks like this:
<pre>
INFO (l.4): No arraysize for character, FIELD implies single character
ERROR (l.7): Element "TABLE" does not allow "DESCRIPTION" here.
WARNING (l.11): Characters after first in char scalar ignored (missing arraysize?)
WARNING (l.15): Wrong number of TDs in row (expecting 3 found 4)
ERROR (l.18): Row count (1) not equal to nrows attribute (2)
</pre>
(Note that the details of the reports will vary according to
the XML parser/validator that forms part of your Java installation.)
</p>
<p>Note also that the warning at line 11 has resulted from
the same error as the
one at line 4 - because the <code>FIELD</code> element has no
<code>arraysize</code> attribute, <code>arraysize="1"</code>
(single character) is assumed,
while the author almost certainly intended <code>arraysize="*"</code>
(unknown length string).
</p>
<p>By examining these warnings you can see what needs to be done to
fix this table up. Here is what it should look like:
<pre>
<VOTABLE version="1.1">
<RESOURCE>
<TABLE nrows="1"> <!-- change row count -->
<DESCRIPTION>A very small table</DESCRIPTION> <!-- move DESCRIPTION -->
<FIELD name="Identifier" datatype="char"
arraysize="*"/> <!-- add arraysize -->
<FIELD name="RA" datatype="double"/>
<FIELD name="Dec" datatype="double"/>
<DATA>
<TABLEDATA>
<TR>
<TD>Fomalhaut</TD>
<TD>344.48</TD>
<TD>-29.618</TD>
</TR> <!-- remove extra TD -->
</TABLEDATA>
</DATA>
</TABLE>
</RESOURCE>
</VOTABLE>
</pre>
When fed this version, <code>votlint</code> gives no warnings.
</p>
<hr><a href="secC.html">Next</a> <a href="secB.39.2.html">Previous</a> <a href="votlint.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="secC.html">Release Notes</a><br>
<b>Up: </b><a href="votlint.html">votlint: Validates VOTable documents</a><br>
<b>Previous: </b><a href="secB.39.2.html">Items Checked</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>
|