svn commit: r1741252 - /jackrabbit/oak/trunk/oak-segment-next/src/main/java/org/apache/jackrabbit/oak/segment/file/FileStore.java

[md...@apache.org]

Author: mduerig
Date: Wed Apr 27 13:10:19 2016
New Revision: 1741252

URL: http://svn.apache.org/viewvc?rev=1741252&view=rev
Log:
OAK-3348: Cross gc sessions might introduce references to pre-compacted segments
Updated Javadoc

Modified:
    jackrabbit/oak/trunk/oak-segment-next/src/main/java/org/apache/jackrabbit/oak/segment/file/FileStore.java

Modified: jackrabbit/oak/trunk/oak-segment-next/src/main/java/org/apache/jackrabbit/oak/segment/file/FileStore.java
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-segment-next/src/main/java/org/apache/jackrabbit/oak/segment/file/FileStore.java?rev=1741252&r1=1741251&r2=1741252&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-segment-next/src/main/java/org/apache/jackrabbit/oak/segment/file/FileStore.java (original)
+++ jackrabbit/oak/trunk/oak-segment-next/src/main/java/org/apache/jackrabbit/oak/segment/file/FileStore.java Wed Apr 27 13:10:19 2016
@@ -860,12 +860,11 @@ public class FileStore implements Segmen
     }
 
     /**
-     * Runs garbage collection on the segment level, which could write new
-     * generations of tar files. It checks which segments are still reachable,
-     * and throws away those that are not.
-     * <p>
-     * A new generation of a tar file is created (and segments are only
-     * discarded) if doing so releases more than 25% of the space in a tar file.
+     * Run garbage collection on the segment level: reclaim those data segments
+     * that are from an old segment generation and those bulk segments that are not
+     * reachable anymore.
+     * Those tar files that shrink by at least 25% are rewritten to a new tar generation
+     * skipping the reclaimed segments.
      */
     public List<File> cleanup() throws IOException {
         Stopwatch watch = Stopwatch.createStarted();