jackrabbit-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ang...@apache.org
Subject svn commit: r1564850 - in /jackrabbit/site/live/oak/docs: differences.html known_issues.html
Date Wed, 05 Feb 2014 17:55:31 GMT
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 &#x201c;fuzzy
locking&#x201d; 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>



Mime
View raw message