1 files changed, 89 insertions, 0 deletions
diff --git a/data/ef/examples/benedictine.ini b/data/ef/examples/benedictine.ini
new file mode 100644
index 0000000..2ca9c89
--- /dev/null
+++ b/data/ef/examples/benedictine.ini
@@ -0,0 +1,89 @@
+; ---------------------------------------------------------------------------
+; BENEDICTINE PROPER -- a DELIBERATELY PARTIAL example, and the reason why is
+; the most useful thing in this file.
+;
+; SOURCE. Ordo Divini Officii ... juxta Ritum Romano-Monasticum et
+; Consuetudines Abbatiae Sancti Benedicti in Monte Nursiae, pro anno 2026
+; (the Monks of Norcia).
+;
+; WHY IT IS SHORT: THE MONASTIC RITE DOES NOT USE THE ROMAN RANKS.
+; The ordo's own vocabulary, counted across the whole document:
+;
+;     I cl.        86        III cl.        0
+;     II cl.       43        IV cl.         0
+;     Semidup.    103        Dup.          ~96
+;
+; It uses the 1960 class system at the TOP -- I and II class -- and the older
+; monastic Duplex / Semiduplex grades BELOW, exactly where the Roman calendar
+; has III and IV class. colitur's rank vocabulary is Class1..Class4. So a
+; Benedictine feast graded "Dup." or "Semidup." CANNOT BE FAITHFULLY
+; EXPRESSED here at all. This is not a gap in the data; it is a mismatch of
+; vocabularies between two related rites.
+;
+; Rather than invent a Dup. -> Class3 mapping the source never states, this
+; file ships ONLY the entries whose class the ordo gives in Roman terms and
+; whose row could be read unambiguously. Everything else is listed at the
+; bottom as excluded, by name, so the omission is visible rather than silent.
+;
+; TWO FURTHER LIMITS, both worth knowing before reusing this:
+;   1. It is "et Consuetudines Abbatiae" -- Norcia's own customs, not the
+;      generic Benedictine calendar. Another house's proper will differ.
+;   2. It is a 2026 ordo, one year, not a perpetual calendar. Any transferred
+;      or movable entry in it reflects that year's outcome, not the rule. The
+;      two entries below are fixed-date and unaffected.
+;
+; NOT AUTHORITATIVE. colitur's test layers assert things about the SHIPPED
+; universal calendar and cannot vouch for this file (see colitur-overlay(5)).
+;
+;   colitur convert benedictine.ini > benedictine.sexp
+;   colitur check benedictine.sexp
+; ---------------------------------------------------------------------------
+
+[overlay]
+id = benedictine-nursia
+
+; "21 SAB. Alb. | ! | IN TRANSITU S.P.N. BENEDICTI ... Dup. I cl."
+; The death of Our Holy Father Benedict, 21 March. I class in the monastic
+; calendar; in the Roman calendar 21 March is St Benedict at III class, so
+; this deliberately OVERRIDES the universal entry by naming a distinct slug on
+; the same date -- both will be candidates, and the I-class one wins.
+[transitus-of-our-holy-father-benedict]
+date    = 03-21
+rank    = class-1
+colour  = white
+name.la = In Transitu S.P.N. Benedicti Abbatis
+name.en = The Passing of Our Holy Father Benedict, Abbot
+
+; "15 ... S. MAURI ABB. (O.N.) | Dup. II cl."
+; (O.N.) = Ordinis Nostri, "of our Order" -- the ordo's own marker for a
+; proper feast of the Order. 39 entries carry it; this is the only one whose
+; class is given in Roman terms AND whose row reads unambiguously.
+[maurus-abbot]
+date    = 01-15
+rank    = class-2
+colour  = white
+name.la = S. Mauri Abbatis
+name.en = St Maurus, Abbot
+
+; ---------------------------------------------------------------------------
+; EXCLUDED, and why. Each of these is a real feast of the Order, present in
+; the ordo and marked (O.N.) or equivalent. None is written above, because its
+; grade is Duplex or Semiduplex -- which this format cannot express -- or
+; because its row could not be read unambiguously from the ordo's two-column
+; layout, and a guessed date is worse than an absent one.
+;
+;   Omnium Sanctorum O.N. (13 Nov)     Dup.       -- All Saints of the Order
+;   S. Scholasticae V. (10 Feb)        row unclear
+;   Ss. Placidi & Sociorum Mm. (5 Oct) row unclear
+;   S. Anselmi Ep. C. D. (21 Apr)      Dup.
+;   S. Bernardi Abb. D. (20 Aug)       Dup.
+;   S. Gertrudis Magnae V. (17 Nov)    (m.t.v.)
+;   S. Silvestri Abb. (26 Nov)         Dup.
+;   and ~20 further (O.N.) entries: Bede, Hildegard, Boniface, Frances of
+;   Rome, John Gualbert, Peter Damian, Leo IV, Robert, Bernard Ptolomei,
+;   Gregory VII, Augustine of Canterbury, and others.
+;
+; To use them, you need either a rank vocabulary colitur does not have, or a
+; deliberate decision -- yours, documented -- about how Duplex and Semiduplex
+; map onto class-3 and class-4. This file does not make that decision for you.
+; ---------------------------------------------------------------------------