summaryrefslogtreecommitdiffstats
path: root/src/document/replica.rs
diff options
context:
space:
mode:
Diffstat (limited to 'src/document/replica.rs')
-rw-r--r--src/document/replica.rs10
1 files changed, 5 insertions, 5 deletions
diff --git a/src/document/replica.rs b/src/document/replica.rs
index 4579029..ff3af4c 100644
--- a/src/document/replica.rs
+++ b/src/document/replica.rs
@@ -1,7 +1,7 @@
//! The local replica: the Automerge document together with the epoch it belongs to.
//!
-//! Compaction (later steps) replaces the document with a snapshot whose history is
-//! unrelated to the old one. Syncing two unrelated histories would make Automerge merge
+//! A remake replaces the document with a new one (for compaction: a snapshot) whose
+//! history is unrelated to the old one. Syncing two unrelated histories would make Automerge merge
//! them, turning every key into a conflict with its own copy, so nodes on different
//! epochs must never sync. Keeping the epoch and the document under one lock makes it
//! impossible to label a sync message from one document with the other's epoch.
@@ -13,10 +13,10 @@ use automerge::AutoCommit;
/// One generation of the cluster document.
///
-/// * `generation` orders epochs: every compaction increments it, so a node can tell
+/// * `generation` orders epochs: every remake increments it, so a node can tell
/// whether a peer is behind or ahead.
/// * `id` is the hash of the epoch's snapshot change. It tells two epochs of the same
-/// generation apart, which only happens if two compactions committed concurrently.
+/// generation apart, which only happens if two remakes committed concurrently.
#[derive(Clone, Copy, PartialEq, Eq, Hash)]
pub struct Epoch {
pub generation: u64,
@@ -31,7 +31,7 @@ pub enum EpochRelation {
PeerBehind,
/// The peer is on a newer generation; we have to migrate.
PeerAhead,
- /// Same generation, different snapshot: competing compactions. Never sync.
+ /// Same generation, different snapshot: competing remakes. Never sync.
Diverged,
}