Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit e6ae8423 authored by Chris Tate's avatar Chris Tate Committed by Android (Google) Code Review
Browse files

Merge "Docs: be explicit about oldState contract for backup helpers"

parents 41925b1c 1203aa05
Loading
Loading
Loading
Loading
+5 −1
Original line number Diff line number Diff line
@@ -50,7 +50,11 @@ public interface BackupHelper {
     * new state after performing the backup operation.
     * <p class="note">
     * <strong>Note:</strong> The helper should not close or seek either the {@code oldState} or
     * the {@code newState} file descriptors.</p>
     * the {@code newState} file descriptors.  It is essential that when reading the helper's
     * saved state from the {@code oldState} file, no extra content is consumed beyond
     * what was stored by this helper.  If more old state data is read, even accidentally,
     * it will make it impossible for additional helpers that may be invoked after this one
     * to properly reconstruct their prior state.</p>
     *
     * @param oldState An open, read-only {@link android.os.ParcelFileDescriptor} pointing to the
     *            last backup state provided by the application. May be