summaryrefslogtreecommitdiff
path: root/bin
diff options
context:
space:
mode:
Diffstat (limited to 'bin')
-rw-r--r--bin/main.ml31
1 files changed, 28 insertions, 3 deletions
diff --git a/bin/main.ml b/bin/main.ml
index acf8859..b1d9cac 100644
--- a/bin/main.ml
+++ b/bin/main.ml
@@ -1942,6 +1942,20 @@ let lang_check path =
it via [load_lang]). *)
let config_show ~lang_flag ~template_flag ~format_flag ~overlays_flag ~sigla_style_flag ~sigla_book_flag
~sigla_tradition_flag config =
+ (* VALIDATE BEFORE PRINTING ANYTHING. A usage error used to surface
+ halfway down the table, so `config --show --sigla-book bogus` exited 2
+ having already written five rows to stdout -- a caller redirecting
+ stdout to a file got a truncated, plausible-looking report alongside a
+ non-zero status. Nothing is emitted now until every value is known good. *)
+ let sigla_book_check, _ =
+ Colitur_naming.Config.resolve ~flag:sigla_book_flag
+ ~config:(Colitur_naming.Config.sigla_book config) ~default:"abbr"
+ in
+ if sigla_book_check <> "full" && sigla_book_check <> "abbr" then begin
+ Printf.eprintf "colitur: unknown --sigla-book %S (want \"full\" or \"abbr\")\n"
+ sigla_book_check;
+ exit 2
+ end;
let cpath = config_path () in
Printf.printf "config file: %s (%s)\n" cpath
(if cpath <> "" && Sys.file_exists cpath then "exists" else "not found");
@@ -1996,8 +2010,13 @@ let new_overlay_template =
; universal entry -- by naming its slug.
((id my-parish)
(directives
- ; A fixed-date local feast. `citations` and `layer` may be omitted: they
- ; default to empty and to this overlay's own id.
+ ; A fixed-date local feast, with its own Mass readings.
+ ;
+ ; NOTE WHERE `citations` AND `layer` GO: inside `cel`, beside `rank` and
+ ; `colour` -- NOT beside `date`. Both may be omitted, defaulting to no
+ ; readings and to this overlay's own id. This example shows them in
+ ; place because the nesting is the single easiest thing to get wrong,
+ ; and getting it wrong is what `unknown field(s): citations` means.
((Add
((date (Fixed (month 5) (day 20)))
(cel
@@ -2007,7 +2026,13 @@ let new_overlay_template =
; status: Feast | Commemoration_only
; colour: White | Red | Violet | Green | Black | Rose
; subject: Lord | Bvm | Saint | Temporal
- (rank Class3) (status Feast) (colour White) (subject Saint)))))
+ (rank Class3) (status Feast) (colour White) (subject Saint)
+ ; part: First | Gospel. The reference is a citation, never
+ ; scripture text -- colitur ships no Bible.
+ (citations
+ (((part First) (reference "Wis 7:7-14"))
+ ((part Gospel) (reference "Matt 5:13-19"))))
+ (layer my-parish)))))
; A MOVABLE feast: the first Sunday of October. `nth` may be negative to
; count from the end of the month (-1 is the last).
(Add