1 files changed, 63 insertions, 0 deletions
diff --git a/man/colitur-config.5 b/man/colitur-config.5
index 8f21028..6b3a574 100644
--- a/man/colitur-config.5
+++ b/man/colitur-config.5
@@ -181,6 +181,69 @@ accepts it. Relevant only to
 which requires a format either from this setting or from
 .BR \-\-format ;
 no default.
+.TP
+.B sigla_style
+Which citation STYLE to render book names and punctuation with: a language
+code, or a path to a file carrying a
+.B [sigla]
+section. Defaults to the resolved
+.IR lang ,
+so a booklet's citations follow its own language unless told otherwise.
+See
+.BR colitur (1)'s
+.B SIGLA
+section for the five style settings.
+.TP
+.B sigla_book
+.BR full " or " abbr .
+Overrides the selected style's own
+.B book
+setting. Default
+.BR abbr ,
+giving
+.B "Luc. 5:12\-14"
+rather than
+.BR "Evangelium secundum Lucam 5:12\-14" .
+An unrecognised value is a hard error, the same discipline as an unknown
+.BR \-\-lang .
+.TP
+.B sigla_tradition
+A section name in
+.IR lang/traditions.ini ,
+deciding which book a reference DENOTES rather than what it is called.
+Default
+.BR vulgate ,
+the identity \(em colitur never renumbers unless asked. With
+.B modern
+the Vulgate's own
+.B "3 Kings 19:3\-8"
+renders as
+.B "1 Reg 19:3\-8"
+in Latin, or
+.B "1 Kgs 19:3\-8"
+under
+.BR "\-\-lang en" .
+In Latin the modern tradition only really moves Kings and Esdras: Osee,
+Ionas, Ecclesiasticus and the Apocalypse keep their Vulgate names either
+way, because modern numbering is a vernacular convention.
+Unlike
+.IR sigla_book ,
+an unrecognised value is NOT fatal: it warns on stderr and falls back to
+.BR vulgate ,
+because asking for a renumbering is optional the way asking for a language
+is not.
+.PP
+Naming and renumbering are deliberately separate mechanisms.
+.I sigla_style
+selects what a book is CALLED, which varies by language;
+.I sigla_tradition
+selects which book a reference DENOTES, which does not \(em "modern
+numbering" is the same decision in Latin, Polish and English. Conflating
+them is how a citation ends up naming the wrong book.
+.PP
+None of these affect
+.BR \-\-raw ,
+which emits every citation exactly as stored, byte for byte.
 .SH UNKNOWN KEYS AND SECTIONS
 A key inside
 .B [defaults]