aboutsummaryrefslogtreecommitdiff
path: root/lib/rites/rite_of/lectionary_of.mli
diff options
context:
space:
mode:
Diffstat (limited to 'lib/rites/rite_of/lectionary_of.mli')
-rw-r--r--lib/rites/rite_of/lectionary_of.mli50
1 files changed, 48 insertions, 2 deletions
diff --git a/lib/rites/rite_of/lectionary_of.mli b/lib/rites/rite_of/lectionary_of.mli
index 0c4d1d6..4a447d2 100644
--- a/lib/rites/rite_of/lectionary_of.mli
+++ b/lib/rites/rite_of/lectionary_of.mli
@@ -110,8 +110,13 @@ val weekday_cycle : year_start:(int -> Date.t) -> Date.t -> weekday_cycle
closed kernel type outside this task's own scope to extend; see
lectionary_of.ml's own implementation comment on this branch for the
full argument. [said] the observed slug.
- - {b Step 3} -- the day's own temporal slug, same three-way lookup.
- {!Colitur_kernel.Mass_formulary.Own_slug}, [said] that slug.
+ - {b Step 3} -- the day's own temporal slug. FIRST tries
+ {!date_keyed_slug} (OLM n. 69.3's date-fixed windows -- the
+ O-Antiphons and the pre-Epiphany run of the Christmas season), THEN
+ falls back to the same three-way slug lookup step 2 uses.
+ {!Colitur_kernel.Mass_formulary.Own_slug} either way, [said] the
+ temporal office's own slug -- {!date_keyed_slug} changes which KEY
+ resolves the citations, not which office is said to have said them.
- A day matching neither gets [(None, [])] -- see data/of/lectionary
.sexp's own provenance header for exactly which days that is, both
directions, measured, not guessed.
@@ -134,3 +139,44 @@ val readings :
date:Date.t ->
temporal_at:(Date.t -> (Vocab_of.season, Vocab_of.rank) Temporal.t) ->
Mass_formulary.t option * Citation.t list
+
+(** OLM 1981 Praenotanda n. 69.3 (the same passage {!weekday_cycle}'s own
+ doc comment cites: "Pro feriis Adventus, temporis Nativitatis et
+ paschalis cyclus eodem modo annualis est: lectiones ideo non
+ mutantur" -- Advent/Christmastide/Paschaltide ferial readings do not
+ change year to year). Every OTHER such family is non-alternating
+ WITHIN a weekday slot ({!weekday_cycle}); two short windows go
+ further and are keyed by CIVIL DATE instead: the O-Antiphon days
+ (17-24 December) and the pre-Epiphany run of the Christmas season
+ (29-31 December, then 2-5 and 7 January) -- verified concretely
+ against lectio's own ini, not merely inferred from the citation: 17
+ December is Gen 49:2,8-10 / Ps 72:1-2,3-4ab,7-8,17 / Matthew 1:1-17
+ regardless which weekday it falls on in a given year.
+ {!Rite_of.Temporal_of}'s own ferial slugs for these same civil dates
+ are WEEKDAY-keyed
+ ({!Rite_of.Temporal_of.christmas_feria_slug}/the Advent ferial
+ branch), so looking one of THOSE slugs up would silently serve
+ whichever OTHER date happens to share that year's weekday alignment
+ -- the defect this function exists to close (bug found by review, not
+ by a test: colitur used to serve 17 December the unrelated
+ "advent-3-mon" reading in years where the two happened to align).
+
+ 6 January is deliberately NOT one of the six Christmas-season dates,
+ despite lectio's own "christmas-jan-6" base existing:
+ {!Rite_of.Temporal_of}'s own [named] fixes Epiphany to 6 January
+ unconditionally (temporal_of.ml, "m = 1 && dd = 6"), so that date is
+ never reached as a ferial by {!readings}'s own step 3 in the first
+ place -- a real lectio entry with no reachable colitur day, the same
+ "structurally unreachable" shape as tools/bootstrap_lectionary_of
+ .ml's own "easter-6-thu"/"advent-4-sat" (see its own [excluded_bases]
+ comment).
+
+ [None] on a Sunday: Advent 4, Holy Family, the Second Sunday after
+ Christmas and the Baptism of the Lord can each land inside these two
+ windows, each is a NAMED office with its own distinct slug
+ ({!Rite_of.Temporal_of.sunday_slug}), and each must keep taking
+ priority over a ferial date -- checked here explicitly rather than
+ trusted to the call site, since this function's whole contract is
+ "this civil date, unconditionally, is this citation", which is false
+ on the Sunday the window shares its calendar date with. *)
+val date_keyed_slug : Date.t -> Slug.t option