diff --git a/FlexibleDiff/Changeset.swift b/FlexibleDiff/Changeset.swift index 2834bae..d9668d7 100644 --- a/FlexibleDiff/Changeset.swift +++ b/FlexibleDiff/Changeset.swift @@ -98,7 +98,11 @@ public struct Changeset { /// start index and the offset. public var mutations = IndexSet() - /// The offset pairs of moves with a mutation flag as the associated value. + /// The offset pairs of moves. + /// + /// These represent only the required moves for reproducing the current version from the + /// previous version — moves being implied by preceding removals and insertions could + /// have been eliminated as an optimization. /// /// The source offset is semantically equivalent to a removal offset, while the /// destination offset is semantically equivalent to an insertion offset.