Documentation.

Author: dkocher

googlestorage/src/main/java/ch/cyberduck/core/googlestorage/GoogleStorageObjectListService.java

@@ -193,6 +193,16 @@ protected AttributedList<Path> list(final Path directory, final ListProgressList
         }
     }
 
+    /**
+     * Determine path from prefix. Path will have duplicate marker set in attributes when all containing files for the
+     * prefix have a delete marker set.
+     *
+     * @param pool      Thread pool to run task with
+     * @param bucket    Bucket
+     * @param directory The directory for which contents are listed
+     * @param prefix    URI decoded common prefix found in directory
+     * @return Path to add to directory list
+     */
     private Future<Path> submit(final ThreadPool pool, final Path bucket, final Path directory, final String prefix) {
         return pool.execute(new BackgroundExceptionCallable<Path>() {
             @Override

s3/src/main/java/ch/cyberduck/core/s3/S3VersionedObjectListService.java

@@ -211,6 +211,16 @@ public AttributedList<Path> list(final Path directory, final ListProgressListene
         }
     }
 
+    /**
+     * Determine path from prefix. Path will have duplicate marker set in attributes when all containing files for the
+     * prefix have a delete marker set.
+     *
+     * @param pool      Thread pool to run task with
+     * @param bucket    Bucket
+     * @param directory The directory for which contents are listed
+     * @param prefix    URI decoded common prefix found in directory
+     * @return Path to add to directory list
+     */
     private Future<Path> submit(final ThreadPool pool, final Path bucket, final Path directory, final String prefix) {
         return pool.execute(new BackgroundExceptionCallable<Path>() {
             @Override
@@ -230,7 +240,7 @@ public Path call() throws BackgroundException {
                                 attr.setCustom(ImmutableMap.of(KEY_DELETE_MARKER, Boolean.TRUE.toString()));
                             }
                         }
-                        // no placeholder but objects inside - need to check if all of them are deleted
+                        // No placeholder but objects inside; need to check if all of them are deleted
                         final StorageObjectsChunk unversioned = session.getClient().listObjectsChunked(
                                 bucket.isRoot() ? StringUtils.EMPTY : bucket.getName(), prefix,
                                 null, 1, null, false);