summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2012-09-09 07:09:58 +0000
committerDavid Robillard <d@drobilla.net>2012-09-09 07:09:58 +0000
commit178a5a788b59d429879ffbf393fb92993b25ea2b (patch)
tree3c93bebb9e6f220436603984a350aaf743e72baa /doc
parentcaa001a6dd87396850284f3b050478d9a82d9184 (diff)
downloadsord-178a5a788b59d429879ffbf393fb92993b25ea2b.tar.gz
sord-178a5a788b59d429879ffbf393fb92993b25ea2b.tar.bz2
sord-178a5a788b59d429879ffbf393fb92993b25ea2b.zip
Implement better data type validation in sord_validate conformant with the XSD and OWL specifications.
Fix memory leaks in sord_validate. git-svn-id: http://svn.drobilla.net/sord/trunk@261 3d64ff67-21c5-427c-a301-fe4f08042e5a
Diffstat (limited to 'doc')
-rw-r--r--doc/sord_validate.139
-rw-r--r--doc/sordi.12
2 files changed, 32 insertions, 9 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>
diff --git a/doc/sordi.1 b/doc/sordi.1
index 8168999..6c53755 100644
--- a/doc/sordi.1
+++ b/doc/sordi.1
@@ -8,7 +8,7 @@ sordi [OPTION]... INPUT BASE_URI
.SH OPTIONS
.TP
-\fB\-h\fR, \fB\-\-help\fR
+\fB\-h\fR
Print the command line options.
.TP