From fd950f027300d3185c7b66b06981eddcfcfead4f Mon Sep 17 00:00:00 2001 From: Lukasz Kasprzak Date: Tue, 28 Jul 2026 23:39:17 +0200 Subject: help: refresh -h/--help for lectio, lectio-ui, lectio-web The help text predated this session's changes. Update all three binaries: - Taglines: drop "(Polish + 4 versions)" -> "offline ... daily readings (OF + EF)". - Versions: state that only the Latin Vulgate is built in; wuj/grb/drb are optional (make build-full, or drop .tsv/.ini into the corpora dir); a missing version renders "(not in )". - --ui-lang: now any code (en, pl, ...), not just pl|en; note names/.ini, ui/.ini, custom calendars and the sanctorale override. - lectio-ui: drop the removed "bt" version and the no-op -o/--offline flag from the help (the tool is fully offline; --offline only ever dropped bt). - lectio-web: drop -o/--offline; add a one-line description of what it serves. No behaviour change; full suite green. --- cmd/lectio-ui/main.go | 10 ++++++---- cmd/lectio-web/main.go | 8 ++++++-- internal/cli/cli.go | 15 +++++++++++---- 3 files changed, 23 insertions(+), 10 deletions(-) diff --git a/cmd/lectio-ui/main.go b/cmd/lectio-ui/main.go index e7e7afd..e58c74d 100644 --- a/cmd/lectio-ui/main.go +++ b/cmd/lectio-ui/main.go @@ -19,21 +19,23 @@ import ( "github.com/lukaszkasprzak/lectio/internal/tui" ) -const helpText = `lectio-ui — interactive daily liturgy reader (Polish + 4 versions) +const helpText = `lectio-ui — interactive offline daily-readings reader (OF + EF) Usage: lectio-ui [DATE] [flags] DATE = YYYY-MM-DD (default: today), any position Flags: - -b, --bible VER start on version: bt,wuj,vul,grb,drb + -b, --bible VER start on version (vul built in; see Versions below) -R, --reader open the Bible reader (book picker) instead of the daily view -a, --all show all parts (override config) - -o, --offline cache/sigla only, no network -l, --lectionary WHICH new|trad (trad -> traditional) -v, --version print the version and exit -h, --help this help -Versions: wuj (Wujek) vul (Wulgata) grb (Grecki) drb (Douay-Rheims) +Versions: vul (Latin Vulgate) is built in. wuj (Wujek), grb (Greek) and drb +(Douay-Rheims) are optional: build with 'make build-full', or drop .tsv + +.ini into ~/.config/lectio/corpora/. ui_language accepts any code (day and +saint names from ~/.config/lectio/names/.ini, labels from ui/.ini). Flags override config. Exit codes: 0 ok, 1 runtime error, 2 usage error. ` diff --git a/cmd/lectio-web/main.go b/cmd/lectio-web/main.go index fb7f185..f8d90b1 100644 --- a/cmd/lectio-web/main.go +++ b/cmd/lectio-web/main.go @@ -15,18 +15,22 @@ import ( "github.com/lukaszkasprzak/lectio/internal/web" ) -const helpText = `lectio-web — browser daily liturgy reader (Polish + 4 versions) +const helpText = `lectio-web — browser offline daily-readings reader (OF + EF) Usage: lectio-web [flags] Flags: -p, --port N port (overrides web_port; 0 = auto) - -o, --offline cache/sigla only, no network -l, --lectionary WHICH new|trad (trad -> traditional) -v, --version print the version and exit -h, --help this help +Serves a local page (default: http://localhost:1099) with the day's readings, +version compare, a Bible reader and bookmarks. Everything renders offline. +Versions and display are set in the page's settings; vul (Latin Vulgate) is +built in, wuj/grb/drb are optional (make build-full, or ~/.config/lectio/corpora/). + Flags override config. Exit codes: 0 ok, 1 runtime error, 2 usage error. ` diff --git a/internal/cli/cli.go b/internal/cli/cli.go index c0c9dea..56de12b 100644 --- a/internal/cli/cli.go +++ b/internal/cli/cli.go @@ -25,20 +25,20 @@ import ( "github.com/lukaszkasprzak/lectio/internal/render" ) -const helpText = `lectio — daily Catholic liturgy readings (Polish + 4 versions) +const helpText = `lectio — offline Catholic daily readings & liturgical calendar (OF + EF) Usage: lectio [DATE] [flags] DATE = YYYY-MM-DD (default: today), any position Flags: -a, --all all readings, not just the gospel - -b, --bible VER one version's text: wuj,vul,grb,drb + -b, --bible VER one version's text (vul built in; see Versions below) -c, --compare LIST versions side by side (comma-separated) -p, --ref REF look up a passage (e.g. "J 3:16") with -b/-c -r, --raw text only, no banner/headings (for piping) -w, --width N wrap width; 0 = detect terminal -l, --lectionary WHICH new|trad (trad -> traditional) - --ui-lang LANG override interface/export language: pl|en + --ui-lang LANG day/saint-name & interface language: any code (en, pl, ...) -P, --pager page reading output (like git); default from config --no-pager never page, even if config sets one --list list all books + abbreviations (dialect from sigla_style) @@ -64,7 +64,14 @@ Flags: -v, --version print the version and exit -h, --help this help -Versions: wuj (Wujek) vul (Wulgata) grb (Grecki) drb (Douay-Rheims) +Versions: vul (Latin Vulgate) is built in. wuj (Wujek), grb (Greek) and drb +(Douay-Rheims) are optional: build with 'make build-full', or drop .tsv + +.ini into ~/.config/lectio/corpora/. A missing version renders "(not in )". + +Localisation: ui_language accepts any code; day/saint names come from +~/.config/lectio/names/.ini and interface labels from ui/.ini +(en/pl built in). Custom calendars go in ~/.config/lectio/calendars/ (use=...); +a full replacement sanctorale in ~/.config/lectio/sanctorale/of.ini or ef.ini. Examples: lectio today's gospel -- cgit v1.3