summaryrefslogtreecommitdiffstats
path: root/src/config/mod.rs
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-19 03:56:57 +0000
committertv <tv@krebsco.de>2026-11-19 05:12:15 +0100
commitefaf79e7fd55db2b9704ccefedde33346f874a1d (patch)
tree245bf0812b7cb95b000928a2739e0ff140352818 /src/config/mod.rs
parent5611555bd31e5b05bcee6c6e4450adeffd2e820b (diff)
vote: a node proposes a checkpoint at the heads it holds
A node proposed a checkpoint at the heads of what it held for a while: every event written in that while, and every one built on an event beside those heads, as one party writing now and then on something old makes them, was beside them, and refused once the store moved. A voter whose while was shorter backed none, one whose while was longer backed it and lost those. It proposes at the heads its store holds, sorted: what was written before is in their history, and only what is written while the vote takes its course may be beside them. It proposes none where they are more than an event may name: under a revision with merge events, it merges them first; otherwise, what is written after does. `--store-held-for` keeps the voters' rule and how long a new proposal holds back a checkpoint. `federation.md`, the guides and the options say so.
Diffstat (limited to 'src/config/mod.rs')
-rw-r--r--src/config/mod.rs4
1 files changed, 2 insertions, 2 deletions
diff --git a/src/config/mod.rs b/src/config/mod.rs
index 0e6e1b9..a1e6328 100644
--- a/src/config/mod.rs
+++ b/src/config/mod.rs
@@ -294,7 +294,7 @@ pub(crate) const OPTIONS: &[OptionSpec] = &[
Kind::Integer,
"COUNT",
None,
- "With store-vote-key: propose a version that only moves to a checkpoint once it holds this many events beyond its checkpoint, at the heads of what it held for a while (store-held-for), where no proposal on the current version holds it back (docs/federation.md, Votes a node casts by itself); it backs what it proposes.",
+ "With store-vote-key: propose a version that only moves to a checkpoint once it holds this many events beyond its checkpoint, at the heads it holds, no more than an event may name, where no proposal on the current version holds it back (docs/federation.md, Votes a node casts by itself); it backs what it proposes.",
),
#[cfg(feature = "federation")]
option(
@@ -318,7 +318,7 @@ pub(crate) const OPTIONS: &[OptionSpec] = &[
Kind::Duration,
"DURATION",
Some("10m"),
- "With store-vote-key: how long it holds an event before it holds it for a while: it proposes a checkpoint at the heads of such, and backs none whose heads leave out one it held for a while before it was proposed.",
+ "With store-vote-key: how long it holds an event before it holds it for a while: it backs no checkpoint whose heads leave out one it held for a while before it was proposed, and a new proposal holds back its checkpoints that long.",
),
#[cfg(feature = "federation")]
option(