summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--man/colitur.151
1 files 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