You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by an...@apache.org on 2014/02/05 18:55:31 UTC
svn commit: r1564850 - in /jackrabbit/site/live/oak/docs: differences.html
known_issues.html
Author: angela
Date: Wed Feb 5 17:55:30 2014
New Revision: 1564850
URL: http://svn.apache.org/r1564850
Log:
OAK-936: Site checkin for project Oak Documentation-0.16-SNAPSHOT
Modified:
jackrabbit/site/live/oak/docs/differences.html
jackrabbit/site/live/oak/docs/known_issues.html
Modified: jackrabbit/site/live/oak/docs/differences.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/differences.html?rev=1564850&r1=1564849&r2=1564850&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/differences.html (original)
+++ jackrabbit/site/live/oak/docs/differences.html Wed Feb 5 17:55:30 2014
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2014-01-30
+ | Generated by Apache Maven Doxia at 2014-02-05
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20140130" />
+ <meta name="Date-Revision-yyyymmdd" content="20140205" />
<meta http-equiv="Content-Language" content="en" />
<title>Jackrabbit Oak - Backward compatibility</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -154,7 +154,7 @@
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2014-01-30</li>
+ <li id="publishDate">Last Published: 2014-02-05</li>
<li class="divider">|</li> <li id="projectVersion">Version: 0.16-SNAPSHOT</li>
@@ -442,6 +442,10 @@
<p>In Oak binaries are typically stored in an external database or (with the TarMK) using a custom data structure in the local file system. The streams returned by Oak are therefore custom <tt>InputStream</tt> subclasses that implement the <tt>available()</tt> method based on whether the next <tt>read()</tt> call will return immediately or if it needs to block to wait for the underlying IO operations.</p>
<p>This difference may affect some clients that make the incorrect assumption that the <tt>available()</tt> method will always return the number of remaining bytes in the stream, or that the return value is zero only at the end of the stream. Neither assumption is correctly based on the <tt>InputStream</tt> API contract, so such client code needs to be fixed to avoid problems with Oak.</p></div>
<div class="section">
+<h2>Locking<a name="Locking"></a></h2>
+<p>Oak does not support the strict locking semantics of Jackrabbit 2.x. Instead a “fuzzy locking” approach is used with lock information stored as normal content changes. If a <tt>mix:lockable</tt> node is marked as holding a lock, then the code treats it as locked, regardless of what other concurrent sessions that might see different versions of the node see or do. Similarly a lock token is simply the path of the locked node.</p>
+<p>This fuzzy locking should not be used or relied as a tool for synchronizing the actions of two clients that are expected to access the repository within a few seconds of each other. Instead this feature is mostly useful as a higher level tool, for example a human author could use a lock to mark a document as locked for a few hours or days during which other users will not be able to modify the document.</p></div>
+<div class="section">
<h2>Same name siblings<a name="Same_name_siblings"></a></h2>
<p>Same name siblings (SNS) are deprecated in Oak. We figured that the actual benefit supporting same name siblings as mandated by JCR is dwarfed by the additional implementation complexity. Instead there are ideas to implement a feature for automatic <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-129">disambiguation of node names</a>.</p>
<p>In the meanwhile we have <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-203">basic support</a> for same name siblings but that might not cover all cases.</p></div>
Modified: jackrabbit/site/live/oak/docs/known_issues.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/oak/docs/known_issues.html?rev=1564850&r1=1564849&r2=1564850&view=diff
==============================================================================
--- jackrabbit/site/live/oak/docs/known_issues.html (original)
+++ jackrabbit/site/live/oak/docs/known_issues.html Wed Feb 5 17:55:30 2014
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2014-01-30
+ | Generated by Apache Maven Doxia at 2014-02-05
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20140130" />
+ <meta name="Date-Revision-yyyymmdd" content="20140205" />
<meta http-equiv="Content-Language" content="en" />
<title>Jackrabbit Oak - Known issues</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -154,7 +154,7 @@
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2014-01-30</li>
+ <li id="publishDate">Last Published: 2014-02-05</li>
<li class="divider">|</li> <li id="projectVersion">Version: 0.16-SNAPSHOT</li>
@@ -408,16 +408,6 @@
</ul></li>
</ul></li>
</ul>
-
-<ul>
-
-<li>Access Control Management and Permissions:
-
-<ul>
-
-<li>Move operations are not properly handled wrt. permissions See <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-710">OAK-710</a></li>
- </ul></li>
-</ul>
<p>In some cases Oak throws Runtime exceptions instead of a properly typed exception. We are working on correcting this. Please do not work around this by adapting catch clauses in your application.</p>
</div>
</div>