From e0b99c1672c2663476dc72f6a95ad00bc1a071b8 Mon Sep 17 00:00:00 2001
From: Lukasz Kasprzak <lukas@labunix.xyz>
Date: Wed, 26 Aug 2026 12:58:17 +0200
Subject: docs(man): document --rite, and correct the now-false OF limitation

man/colitur.1 documented no --rite flag at all, though the branch adds
it to two commands and ships a whole second rite. Add it to the
day|readings SYNOPSIS line, describe its default/values/refusal
behaviour (matching reject_rite_for's real behaviour) in COMMANDS, and
add the OF data directory to FILES.

While there, LIMITATIONS still said "Only the Extraordinary Form
(1962) is implemented; the Ordinary Form is a planned peer module" --
flatly false now that --rite of is a working, installed feature, and
directly contradicting the flag just documented two sections above it
in the same file. Replaced with an honest statement of the OF's
current validation gap relative to the EF (no published-ordo witness,
known-wrong pinned dates, first reading + Gospel only).
---
 man/colitur.1 | 51 +++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 49 insertions(+), 2 deletions(-)

diff --git a/man/colitur.1 b/man/colitur.1
index 3f485d5..a55e476 100644
--- a/man/colitur.1
+++ b/man/colitur.1
@@ -9,6 +9,7 @@ colitur \- deterministic liturgical calendar and lectionary engine (Roman rite,
 .B colitur
 .BR day | readings
 .I YEAR
+.RB [ \-\-rite " ef\(brof" ]
 .RB [ \-\-overlay " FILE" " ...]"
 .RB [ \-\-lang " CODE\(brFILE" ]
 .RB [ \-\-sigla\-style " CODE\(brFILE" ]
@@ -121,6 +122,32 @@ occurrence, commemoration and transfer.
 .BI readings " YEAR"
 The Mass reading citations, one line per day.
 .TP
+.BR \-\-rite " " ef\(brof
+Select the rite module.
+.B ef
+(the default \(em an invocation with no
+.B \-\-rite
+at all is byte\-identical to before this flag existed) computes the Roman
+.B EF
+(1962); the alternative,
+.BR of ", " computes the Roman
+.B OF
+(the post\-1970 Missal, base calendar the 2002
+.IR Missale Romanum ,
+editio typica tertia). Accepted only by
+.B day
+and
+.BR readings ;
+every other command refuses it rather than silently ignoring it, printing
+one line to standard error and exiting
+.BR 2 .
+The OF module is younger than the EF one: it has no published\-ordo witness
+yet, its lectionary's English text is niedziela.pl's own translation
+lineage (not the USA\-English one), and a handful of dates are known\-wrong
+and pinned rather than fixed \(em see
+.B LIMITATIONS
+below.
+.TP
 .BI rubrics " YEAR"
 Four rubrics of the Mass, one line per day: which formulary is actually
 said \(em not always the day's own: a weekday with no proper resumes the
@@ -1476,6 +1503,15 @@ mode this program refuses.
 The installed calendar data: the sanctoral calendar, its one hand\-authored
 overlay, the temporal lectionary and the Commons. Four S\-expression files.
 .TP
+.I <prefix>/share/colitur/of/
+The installed OF calendar data, read only when
+.B \-\-rite of
+is given: the 2002 General Roman Calendar, its thirteen decree\-chronological
+amendment overlays, and the temporal + sanctoral lectionary. Not consulted
+by
+.BR COLITUR_DATA_DIR ,
+which is EF\-only; see below.
+.TP
 .I <prefix>/share/colitur/examples/diocesan\-example.sexp
 A worked example overlay, shipped as runnable documentation. Every
 celebration in it is invented; copy it and put your own calendar in its place.
@@ -1600,8 +1636,19 @@ and local patrons are excluded from every comparison), one civil year, and
 one publisher's transcription \(em a divergence against it is a question,
 not a verdict, the same discipline applied to every other oracle here.
 .SH LIMITATIONS
-Only the Extraordinary Form (1962) is implemented; the Ordinary Form is a
-planned peer module, not an overlay of this one.
+Two rites are implemented, selected with
+.BR \-\-rite " (see above)."
+The Extraordinary Form (EF, 1962) is the default and the more thoroughly
+validated of the two, against five independent layers including a
+published Ordo witness. The Ordinary Form (OF, the post\-1970 Missal, base
+calendar the 2002
+.I Missale Romanum )
+is younger: it has no published\-ordo witness yet, a handful of dates are
+known\-wrong and pinned rather than fixed (St Joseph anticipated onto Palm
+Sunday, Normae n. 56(f); the Holy Family Sunday fallback of Normae n. 35(a)),
+and on a Sunday or solemnity its lectionary carries only the first reading
+and the Gospel, not the Second Reading (the Apostle) or the responsorial
+psalm.
 .PP
 Only the Epistle and the Gospel are emitted. The chants \(em Psalm, Gradual,
 Tract, Alleluia, Sequence \(em are deliberately not computed: they have no
-- 
cgit v1.3