aboutsummaryrefslogtreecommitdiff
path: root/lib/rites/rite_ef/rite_ef.mli
diff options
context:
space:
mode:
Diffstat (limited to 'lib/rites/rite_ef/rite_ef.mli')
-rw-r--r--lib/rites/rite_ef/rite_ef.mli17
1 files changed, 12 insertions, 5 deletions
diff --git a/lib/rites/rite_ef/rite_ef.mli b/lib/rites/rite_ef/rite_ef.mli
index 12f5609..2183799 100644
--- a/lib/rites/rite_ef/rite_ef.mli
+++ b/lib/rites/rite_ef/rite_ef.mli
@@ -26,10 +26,12 @@ module Lectionary_ef = Lectionary_ef
value's own documentation for the termination and forward-progress
argument {!Colitur_kernel.Rite.t.transfer_target}'s contract requires).
- [readings]: {!Lectionary_ef.readings} partially applied to the caller's
- own [~lectionary] -- the observed celebration's own proper, else the
- day's own temporal slug, else (a weekday with no entry of its own) the
- preceding Sunday's temporal slug, in data/ef/lectionary.sexp (chain
- steps 1-3; the Commons are later work).
+ own [~lectionary] and [~commons] -- the observed celebration's own
+ proper, else (for a saint who is the day's observed office) his
+ assigned Common from data/ef/commons.sexp, else the day's own temporal
+ slug, else (a weekday with no entry of its own) the preceding Sunday's
+ temporal slug, in data/ef/lectionary.sexp. See {!Lectionary_ef.readings}
+ for why the Common is consulted second rather than last.
Deliberately carries no [sanctoral]/[lectionary] fields the way the
original design-doc sketch of [RITE] does: {!Colitur_kernel.Rite.t} (the
@@ -44,7 +46,12 @@ module Lectionary_ef = Lectionary_ef
that never touches lectionary data at all the moment that file was
missing from a bare build -- see the task report). A future
diocesan/proper lectionary overlay has a caller-side seam to attach to
- for the same reason the sanctoral overlay already does. *)
+ for the same reason the sanctoral overlay already does. [~commons]
+ travels the same seam, and is deliberately REQUIRED rather than
+ defaulted -- see this module's .ml for why a silently-defaulted
+ {!Lectionary_ef.Commons.empty} would be undetectable by any of the five
+ validation layers. *)
val context :
lectionary:Colitur_kernel.Lectionary.t ->
+ commons:Lectionary_ef.Commons.t ->
(Vocab_ef.season, Vocab_ef.rank) Colitur_kernel.Rite.t