svn commit: r1538532 - in /jackrabbit/oak/trunk/oak-doc/src/site/markdown: differences.md query.md

[th...@apache.org]

Author: thomasm
Date: Mon Nov  4 09:04:52 2013
New Revision: 1538532

URL: http://svn.apache.org/r1538532
Log:
OAK-301 Document Oak - more query docs

Modified:
    jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences.md
    jackrabbit/oak/trunk/oak-doc/src/site/markdown/query.md

Modified: jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences.md
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences.md?rev=1538532&r1=1538531&r2=1538532&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences.md (original)
+++ jackrabbit/oak/trunk/oak-doc/src/site/markdown/differences.md Mon Nov  4 09:04:52 2013
@@ -76,9 +76,12 @@ Query
 Oak does not index content by default as does Jackrabbit 2. You need to create custom indexes when
 necessary, much like in traditional RDBMSs. If there is no index for a specific query then the
 repository will be traversed. That is, the query will still work but probably be very slow.
-
 See the [query overview page](query.html) for how to create a custom index.
 
+There were some smaller bugfixes in the query parser which might lead to incompatibility.
+See the [query overview page](query.html) for details.
+
+
 Observation
 -----------
 

Modified: jackrabbit/oak/trunk/oak-doc/src/site/markdown/query.md
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-doc/src/site/markdown/query.md?rev=1538532&r1=1538531&r2=1538532&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-doc/src/site/markdown/query.md (original)
+++ jackrabbit/oak/trunk/oak-doc/src/site/markdown/query.md Mon Nov  4 09:04:52 2013
@@ -41,6 +41,20 @@ Every conversion is logged in `debug` le
 
 _Each transformed SQL2 query contains the original XPath query as a comment._
 
+### Compatibility
+
+The query parser is now generally more strict about invalid syntax.
+The following query used to work in Jackrabbit 2.x, but not in Oak,
+because multiple way to quote the path are used at the same time:
+
+    SELECT * FROM [nt:base] AS s 
+    WHERE ISDESCENDANTNODE(s, ["/libs/sling/config"])
+    
+Instead, the query now needs to be:
+
+    SELECT * FROM [nt:base] AS s 
+    WHERE ISDESCENDANTNODE(s, [/libs/sling/config])
+
 ### Query Processing
 
 Internally, the query engine uses a cost based query optimizer that asks all the available