aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorLukasz Kasprzak <lukas@labunix.xyz>2026-07-29 08:57:11 +0200
committerLukasz Kasprzak <lukas@labunix.xyz>2026-07-29 08:57:11 +0200
commitf16b5d713bcd839a250bf17241c734316389b5fb (patch)
tree8328d3cef8d1122922534c389934709fbc27ed11 /README.md
parent4290b7b2cbeeba4f08446f15c04b64d70dedbabc (diff)
downloadclectio-f16b5d713bcd839a250bf17241c734316389b5fb.tar.gz
clectio-f16b5d713bcd839a250bf17241c734316389b5fb.zip
feat: --month [YYYY-MM | N] month overview
List a whole month, one line per day: weekday, day, liturgical colour and celebration name. Form-aware; colours the name on a tty and prints the colour word (aligned column) always, so a piped file stays readable. Defaults to the current month; accepts YYYY-MM or a bare month number (current year). Needs no scripture text, so it never loads or decompresses the text blob. Days-in-month and weekday are computed with days_from_civil (leap-correct); a month outside the compiled range is reported, not guessed. No table/data change; OF and EF build clean under -Wall -Wextra; binary unchanged at 666 KB. Claude-Session: https://claude.ai/code/session_01S1CD1u3tgSS4xNu6WHfp5a
Diffstat (limited to 'README.md')
-rw-r--r--README.md12
1 files changed, 8 insertions, 4 deletions
diff --git a/README.md b/README.md
index 2fea861..eb763e2 100644
--- a/README.md
+++ b/README.md
@@ -18,14 +18,18 @@ the Go engine that computes and generates clectio's data.
./clectio 2026-12-25 # a given date
./clectio -g 2026-12-25 # the Gospel only
./clectio -a # all readings (override a Gospel-only build)
+ ./clectio --month # this month at a glance (day, colour, celebration)
+ ./clectio --month 2026-04 > apr.txt # a month to a file for reference
make install # into $PREFIX/bin (default /usr/local)
Needs only a C99 compiler and libc. It builds in about a second.
-The only run-time options are `-a`/`--all`, `-g`/`--gospel` (which reading set
-to print, overriding the compiled default) and `-h`/`--help`; everything else is
-compile-time. Reading text wraps to the terminal width by default (see `WRAP`);
-piped output is left one line per verse.
+The run-time options are `-a`/`--all`, `-g`/`--gospel` (which reading set to
+print, overriding the compiled default), `--month [YYYY-MM | N]` (one line per
+day of a month — weekday, colour and celebration, no readings; defaults to the
+current month) and `-h`/`--help`. Everything else is compile-time. Reading text
+wraps to the terminal width by default (see `WRAP`); piped output is left one
+line per verse.
## Configure (suckless style)