jena-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r827058 - in /websites/staging/jena/trunk/content: ./ documentation/tools/index.html
Date Thu, 26 Jul 2012 16:31:26 GMT
Author: buildbot
Date: Thu Jul 26 16:31:26 2012
New Revision: 827058

Log:
Staging update by buildbot for jena

Modified:
    websites/staging/jena/trunk/content/   (props changed)
    websites/staging/jena/trunk/content/documentation/tools/index.html

Propchange: websites/staging/jena/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Jul 26 16:31:26 2012
@@ -1 +1 @@
-1363261
+1366072

Modified: websites/staging/jena/trunk/content/documentation/tools/index.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/tools/index.html (original)
+++ websites/staging/jena/trunk/content/documentation/tools/index.html Thu Jul 26 16:31:26
2012
@@ -164,7 +164,8 @@ a variety of tasks in developing Jena-ba
 <li><a href="schemagen.html">schemagen</a></li>
 <li><a href="eyeball-getting-started.html">eyeball</a></li>
 </ul>
-<h3 id="how-to-set-up-the-classpath-and-run-jena-command-line-tools">How to set up
the CLASSPATH and run Jena command line tools</h3>
+<h3 id="setting-up-your-environment">Setting up your Environment</h3>
+<p>An environment variable <code>JENAROOT</code> is used by all the command
line tools to configure the class path automatically for you.  You can set this up as follows:</p>
 <p><strong>On Linux / Mac</strong></p>
 <ul>
 <li><code>export JENAROOT=</code><em>the directory you downloaded
Jena to</em></li>
@@ -175,6 +176,34 @@ a variety of tasks in developing Jena-ba
 <li><code>SET JENAROOT=</code><em>the directory you downloaded Jena
to</em></li>
 <li><code>SET PATH=%PATH%;%JENAROOT%\bat</code></li>
 </ul>
+<h3 id="running-the-tools">Running the Tools</h3>
+<p>Once you've done the above you should now be able to run the tools from the command
line like so:</p>
+<p><strong>On Linux / Mac</strong></p>
+<ul>
+<li><code>sparql --version</code></li>
+</ul>
+<p><strong>On Windows</strong></p>
+<ul>
+<li><code>sparql.bat --version</code></li>
+</ul>
+<p>This command will simply print the versions of Jena and ARQ used in your distribution,
all the tools support the <code>--version</code> option.  To find out how to use
a specific tool add the <code>--help</code> flag instead.</p>
+<p>Note that many examples of using Jena tools typically use the Linux style invocation
because most of the Jena developers work on Linux/Mac platforms.  When running on windows
simply add <code>.bat</code> as an extension to the name of the command line tool
to run it, on some versions of Windows this may not be required.</p>
+<h3 id="common-issues-with-running-the-tools">Common Issues with Running the Tools</h3>
+<p>If you receive errors stating that a class is not found then it is most likely that
<code>JENAROOT</code> is not set correctly.  As a quick sanity check you can try
the following to see if it is set appropriately:</p>
+<p><strong>On Linux / Mac</strong></p>
+<ul>
+<li><code>cd $JENAROOT</code></li>
+</ul>
+<p><strong>On Windows</strong></p>
+<ul>
+<li><code>cd %JENAROOT%</code></li>
+</ul>
+<p>If this command fails then <code>JENAROOT</code> is not correctly set,
please ensure you have set it correctly and try again.</p>
+<p>Windows users may experience problems if trying to run the tools when their <code>JENAROOT</code>
path contains spaces in it, there are two workarounds for this:</p>
+<ol>
+<li>Move your Jena install to a path without spaces</li>
+<li>Grab the latest scripts from <a href="http://svn.apache.org/viewvc/jena/trunk/apache-jena/bat/">Trunk</a>
where they have been fixed to safely handle this.  Future releases will include this fix and
resolve this issue</li>
+</ol>
   </div>
 
   <div id="footer">



Mime
View raw message