aboutsummaryrefslogtreecommitdiff
path: root/man/colitur-overlay.5
diff options
context:
space:
mode:
Diffstat (limited to 'man/colitur-overlay.5')
-rw-r--r--man/colitur-overlay.530
1 files changed, 30 insertions, 0 deletions
diff --git a/man/colitur-overlay.5 b/man/colitur-overlay.5
index f1360e2..7650dfc 100644
--- a/man/colitur-overlay.5
+++ b/man/colitur-overlay.5
@@ -228,6 +228,36 @@ Recolour a universal entry without otherwise touching it:
A worked file exercising all four directives and all three date shapes is
installed at
.IR <prefix>/share/colitur/examples/diocesan\-example.sexp .
+Every celebration in it is invented, with
+.B example\-
+slugs, so that nothing in it can be mistaken for calendar data.
+.PP
+Two REAL local calendars ship beside it, in the flat INI form:
+.TP
+.I examples/poland.ini
+The proper calendar of the dioceses of Poland, from the
+.I Calendarium Perpetuum pro Dioecesium Poloniae
+(1964). Seventeen entries. Its header records which classes were read from
+the source and which are colitur's inference, and warns about the 1921 and
+1934
+.I Proprium Poloniae
+still bound into many missals \(em an outdated arrangement of dioceses and
+ranks that is easy to mistake for this calendar.
+.TP
+.I examples/benedictine.ini
+Two entries, and deliberately so. The monastic rite grades feasts
+.B Duplex
+and
+.B Semiduplex
+below II class, where the Roman calendar has III and IV class, so most
+Benedictine propers cannot be expressed in this format at all. Rather than
+invent a mapping the source does not state, that file ships only what its
+ordo gives in Roman terms and lists the rest by name as excluded. It is worth
+reading for that reason more than for its two feasts.
+.PP
+.B Both are examples, not authorities.
+They are transcriptions from published ordines, and none of this program's
+test layers can vouch for either \(em check them against your own ordo.
.SH HOW AN OVERLAY IS APPLIED
Worth understanding, because the commonest surprise \(em "my feast does not
appear" \(em is almost never a loading failure.