Next Previous Up Contents
Next: Items Checked
Up: votlint: Validates VOTable documents
Previous: votlint: Validates VOTable documents

### B.41.1 Usage

The usage of `votlint` is

       stilts <stilts-flags> votlint validate=true|false
                                     version=1.0|1.1|1.2|1.3|1.4 out=<location>
                                     [votable=]<location>

If you don't have the `stilts` script installed, write "`java -jar stilts.jar`" instead of "`stilts`" - see Section 3. The available `<stilts-flags>` are listed in Section 2.1. For programmatic invocation, the Task class for this command is `uk.ac.starlink.ttools.task.VotLint`.

Parameter values are assigned on the command line as explained in Section 2.3. They are as follows:

`out = <location>` (uk.ac.starlink.util.Destination)
  Destination file for output messages. May be a filename or "-" to indicate standard output.

  [Default: `-`]

`validate = true|false` (Boolean)
  Whether to validate the input document aganist the VOTable DTD. If true (the default), then as well as `votlint`'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 `votlint`'s own checks are performed. In this case many violations of the VOTable standard concerning document structure will go unnoticed.

  [Default: `true`]

`version = 1.0|1.1|1.2|1.3|1.4` (uk.ac.starlink.votable.VOTableVersion)
  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.

  If no value is provided for this parameter (the default), the version will be determined from the VOTable itself.

`votable = <location>` (InputStream)
  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).

Next Previous Up Contents
Next: Items Checked
Up: votlint: Validates VOTable documents
Previous: votlint: Validates VOTable documents

STILTS - Starlink Tables Infrastructure Library Tool Set
Starlink User Note256
STILTS web page: http://www.starlink.ac.uk/stilts/
Author email: m.b.taylor@bristol.ac.uk
Mailing list: topcat-user@jiscmail.ac.uk