summaryrefslogtreecommitdiffstats
path: root/doc/sord_validate.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/sord_validate.1')
-rw-r--r--doc/sord_validate.139
1 files changed, 31 insertions, 8 deletions
diff --git a/doc/sord_validate.1 b/doc/sord_validate.1
index 602707f..9b8668a 100644
--- a/doc/sord_validate.1
+++ b/doc/sord_validate.1
@@ -6,18 +6,41 @@
.SH SYNOPSIS
sord_validate [OPTION]... INPUT...
+.SH OPTIONS
+.TP
+\fB\-h\fR
+Print the command line options.
+
+.TP
+\fB\-l\fR
+Print errors on a single line.
+
+.TP
+\fB\-v\fR
+Display version information and exit.
+
+.SH DESCRIPTION
This is a simple validator which checks that all used properties are actually
defined, and that the domain and range of properties is explicitly correct.
Note that an "error" from this program does not necessarily mean data is
invalid, since it is not required to explicitly list types in RDF, however it
-is a good idea to do so. If data type definitions are available with an
-xsd:pattern property, literals with that datatype will be checked against the
-xsd:pattern (a regular expresssion) to ensure they are valid.
-
-This program does not retrieve any data from the web or magical places on the
-file system. It only processes files passed directly on the command line.
-This means you must pass all used vocabularies to get a useful result.
-
+is a good idea to do so.
+
+This program never retrieves data from the web or magical places on the file
+system, it only processes files passed directly on the command line. This
+means you must pass all used vocabularies to get a useful result.
+
+If an appropriate schema is available, literals are checked against datatype
+definitions (both the explicit datatype of the literal itself as well as any
+types implied by the corresponding property). Three XML Schema Datatypes (XSD)
+constraints are currently supported: regular expressions (xsd:pattern), and
+inclusive range (xsd:minimumInclusive and xsd:maximumInclusive). Given an
+appropriate schema, this is enough to validate against most of the standard XSD
+datatypes.
+
+.SH EXAMPLES
+sord_validate `find ~/schemas/ -name '*.ttl'` data.ttl
+
.SH AUTHOR
sord_validate was written by David Robillard <d@drobilla.net>