Fix the formulation of a comment in TreeCreator
Change-Id: I07d6a4e54437a3369a965e8580e22087f6e3619e
diff --git a/java/com/google/gerrit/server/edit/tree/TreeCreator.java b/java/com/google/gerrit/server/edit/tree/TreeCreator.java
index 966e38ac..45f877e 100644
--- a/java/com/google/gerrit/server/edit/tree/TreeCreator.java
+++ b/java/com/google/gerrit/server/edit/tree/TreeCreator.java
@@ -87,11 +87,12 @@
private void ensureTreeModificationsDoNotTouchSameFiles() {
// The current implementation of TreeCreator doesn't properly support modifications which touch
- // the same files even if they are provided in a logical order. According to JGit's
- // documentation, DirCache applies some internal sorting to optimize the index modifications.
- // The internal sorting doesn't seem to be the only issue, though. Even applying the
- // modifications in batches within different, subsequent DirCaches just held in memory didn't
- // seem to work. We might need to fully write each batch to disk before creating the next.
+ // the same files even if they are provided in a logical order. One reason for this is that
+ // JGit's DirCache implementation sorts the given path edits which is necessary due to the
+ // nature of the Git index. The internal sorting doesn't seem to be the only issue, though. Even
+ // applying the modifications in batches within different, subsequent DirCaches just held in
+ // memory didn't seem to work. We might need to fully write each batch to disk before creating
+ // the next.
ImmutableList<String> filePaths =
treeModifications.stream()
.flatMap(treeModification -> treeModification.getFilePaths().stream())
