Author: andy
Date: Wed Jul 24 07:23:44 2013
New Revision: 1506422
URL: http://svn.apache.org/r1506422
Log:
Remove RDQL mentions. Update setup.
Modified:
jena/site/trunk/content/documentation/query/cmds.mdtext
Modified: jena/site/trunk/content/documentation/query/cmds.mdtext
URL:
http://svn.apache.org/viewvc/jena/site/trunk/content/documentation/query/cmds.mdtext?rev=1506422&r1=1506421&r2=1506422&view=diff
==============================================================================
--- jena/site/trunk/content/documentation/query/cmds.mdtext (original)
+++ jena/site/trunk/content/documentation/query/cmds.mdtext Wed Jul 24 07:23:44
2013
@@ -5,19 +5,18 @@ queries, parse queries, process result s
You will need to set the classpath, or use the helper scripts, to
run these applications from the command line. The helper scripts
-are in `bin/` (Linux, Unix, Cygwin) and `bat/` (Windows)
+are in `bin/` (Linux, Unix, Cygwin, OS/X) and `bat/` (Windows)
directories. There are ancillary scripts in the directories that
-the main commands need - you should put the relevant directory on
-your command path and set the `ARQROOT` environment variable after
-checking these scripts are suitable.
+the main commands need - see [the tools page](../tools/index.html)
+for setup details.
- [`arq.query`](#arqquery) is the main query driver.
- It can be called for SPARQL, ARQ or RDQL queries and there are
- wrapper commands for each language: `arq.sparql`, `arq.arq` and
- `arq.rdql`.
- [`arq.qparse`](#arqqparse) : parse and print a
- query.
+ SPARQL query.
+
+- [`arq.uparse`](#arquparse) : parse and print a
+ SPARQL update.
- [`arq.update`](#arqupdate) : execute SPARQL/Update
requests.
@@ -27,8 +26,6 @@ checking these scripts are suitable.
- [`arq.rset`](#arqrset) : transform result sets.
-- [`arq.qtest`](#arqqtest) : run a test set.
-
- [`arq.qexpr`](#arqqexpr) : evaluate and print an
expression.
@@ -37,13 +34,9 @@ arguments.
When using a query in a file, if the query file ends .rq, it is
assumed to be a SPARQL query. If it ends .arq, it is assumed to be
-an ARQ query (extensions to SPARQL) and if it ends .rdql, it is
-assumed to be an RDQL query. You can specify the syntax
+an ARQ query (extensions to SPARQL). You can specify the syntax
explicitly.
-The commands `jena.query`, `jena.sparql`, `jena.qtest` and
-`jena.rset` are equivalent and just call to these commands.
-
### `arq.query`
This is the main command for executing queries on data. The
@@ -73,22 +66,30 @@ specified on the command line.
### `arq.qparse`
-Parse a query and print it out. Can be used to translate between
-syntaxes (but not perfectly - specifically, RDQL value constraints
-need further conversion as complete mechanical translation is not
-possible).
+Parse a query and print it out.
`arq.qparse` will parse the query, print it out again (with line
numbers by default) and then parse the serialized query again. If
your query has a syntax error, a message is printed but no query is
printed. If a query is printed then you get a syntax error message,
then your query was syntactically correct but the ARQ serialization
-is broken.
+is broken. Please report this.
The command `arq.qparse --print=op --file <i>queryFile</i>`will
print the SPARQL algebra for the query in
[SSE format](../notes/sse.html).
+### `arq.uparse`
+
+Parse a SPARQL update print it out.
+
+`arq.uparse` will parse the update, print it out again (with line
+numbers by default) and then parse the serialized update again. If
+your update has a syntax error, a message is printed but no update is
+printed. If a update is printed then you get a syntax error message,
+then your query was syntactically correct but the ARQ serialization
+is broken. Please report this.
+
### `arq.update`
Execute [SPARQL Update](http://www.w3.org/TR/sparql11-update/)
