aboutsummaryrefslogtreecommitdiffstats
path: root/src/document/file.rs
diff options
context:
space:
mode:
Diffstat (limited to 'src/document/file.rs')
-rw-r--r--src/document/file.rs9
1 files changed, 5 insertions, 4 deletions
diff --git a/src/document/file.rs b/src/document/file.rs
index 1a33918..54ab9af 100644
--- a/src/document/file.rs
+++ b/src/document/file.rs
@@ -7,10 +7,11 @@
//! many bytes, the first of them its kind (`Record`): first a full save of the document,
//! then increments (the changes after the heads written before), and the signatures of
//! its changes (`document::signatures`), those the file holds none of yet, as
-//! `signatures::pack` packs them; last, at a clean stop, an empty `Closed` record: the
-//! file holds everything the node wrote, so it may resume as `current`
-//! (`--keep-actor`). A record cut short by a crash is dropped when
-//! reading. A file of `continuum-document/1` has records of the document alone,
+//! `signatures::pack` packs them; at a clean stop, an empty `Closed` record: the file
+//! holds everything the node wrote, so it may resume as `current` (`--keep-actor`); and
+//! as a node starts on the file, before it writes anything, an empty `Opened` record,
+//! which undoes that mark. A record cut short by a crash is dropped when reading; one of
+//! a kind this version doesn't know (a later version's) makes the file unusable. A file of `continuum-document/1` has records of the document alone,
//! without their kind: a full save, then increments.
//!
//! Written by a worker (`swarm::document_file`), only while the node is ready and not