This file is indexed.

/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 &lt;stilts-flags&gt; votlint validate=true|false version=1.0|1.1|1.2|1.3
                                 out=&lt;location&gt;
                                 [votable=]&lt;location&gt;
</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>&lt;stilts-flags&gt;</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 = &lt;location&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<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> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<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> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<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 = &lt;location&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<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>