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
|
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Jing version 20030619</title>
</head>
<body>
<h1>Jing version 20030619</h1>
<p>Copyright © 2001, 2002, 2003 Thai Open Source Software Center
Ltd. Jing can be freely copied subject to these <a
href="doc/copying.html">conditions</a>.</p>
<p>This directory contains version 20030619 of Jing, a validator for
RELAX NG and other schema languages.</p>
<p>The directory <code>bin</code> contains <code>.jar</code>
files, ready for use with a a Java runtime.</p>
<p>Version 1.4 of the Java Runtime Environment (JRE), is recommended,
which can be downloaded <a
href="http://java.sun.com/j2se/1.4/download.html">here</a>, since this
is what this version of Jing has been tested with. Version 1.1 or
later should also work, although some functionality may be present
only with version 1.2 or later.</p>
<p>Jing is a command-line application. Once you have installed JRE
1.4, you can run Jing by using the command:</p>
<pre>java -jar <var>path-to-dist</var>/jing-20030619/bin/jing.jar <var>file</var>.rng <var>file</var>.xml</pre>
<p>If <code><var>file</var>.rng</code> is a correct schema and
<code><var>file</var>.xml</code> is valid with respect to
<code><var>file</var>.rng</code>, then Jing will generate no output.
Otherwise, it will generate one or more error messages.</p>
<p>Apart from <code>jing.jar</code>, the <code>bin</code> directory
contains some third-party jar files, which are used for XML parsing
(under a pre-1.4 JRE that does not provide the Java XML parsing
extension) and for validating with <a
href="doc/jing-other.html">schema languages other than RELAX
NG</a>:</p>
<dl>
<dt><code>saxon.jar</code></dt>
<dd>Comes from the <a href="http://saxon.sourceforge.net/">Saxon</a>
6.5.2 distribution. Used for Schematron validation.</dd>
<dt><code>xercesImpl.jar</code></dt>
<dt><code>xml-apis.jar</code></dt>
<dd>Come from the <a
href="http://xml.apache.org/xerces2-j/">Xerces-J</a> 2.4.0
distribution. Used for W3C XML Schema validation and for XML
parsing. Xerces-J's license requires the following
acknowledgment. "This product includes software developed by the
Apache Software Foundation (http://www.apache.org/)."</dd>
<dt><code>isorelax.jar</code></dt>
<dd>Comes from <a
href="http://sourceforge.net/projects/iso-relax/">ISO RELAX</a>
2003/01/08 distribution. Provides a bridge to validators that use the
JARV interface.</dd>
</dl>
<p>When you use <code>jing.jar</code> with the <code>-jar</code>
option, the above <code>.jar</code> files will be used automatically,
provided they are in the same directory as <code>jing.jar</code> and
provided they have not been renamed. When using the <code>-jar</code>
option, the JRE will ignore any additional class path entries
specified by the <code>-cp</code> or <code>-classpath</code> options
or by the <code>CLASSPATH</code> environment variable.</p>
<p>If you do not want use the <code>-jar</code> option (perhaps
because you want to use additional <code>.jar</code> files not shipped
with Jing), then you must explicitly include all the needed
<code>.jar</code> files with a <code>-cp</code> or
<code>-classpath</code> option or with the <code>CLASSPATH</code>
environment variable, and specify a class name of
<code>com.thaiopensource.relaxng.util.Driver</code>. For example,
using a Bourne-compatible shell, you could do:</p>
<pre>
d=<var>path-to-dist</var>/jing-20030619/bin
CLASSPATH=$d/jing.jar:$d/xercesImpl.jar:$d/xml-apis.jar:$d/saxon.jar:$d/isorelax.jar
export CLASSPATH
java com.thaiopensource.relaxng.util.Driver <var>file</var>.rng <var>file</var>.xml
</pre>
<p>For more information about the features and usage of Jing, see this
<a href="doc/jing.html">document</a>.</p>
<p>The source code is in the file <code>src.zip</code>.</p>
</body>
</html>
|
