diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 32 |
1 files changed, 32 insertions, 0 deletions
@@ -35,3 +35,35 @@ how it is painted. correct rendering for `æ`/`œ` and Polish diacritics. Not worth it. - A tiling window manager will ignore the size hints and give the grid its own tile; the layout handles that, the empty space is the WM's choice. + +## colitur-mu — the microui variant + +`colitur-mu` is the same idea with an *editable* surface: year, language, +book-name form and numbering tradition are buttons, and changing any of them +re-runs colitur and reloads. It reimplements no calendar logic — every value +on screen came out of `colitur emit --format csv`, and the exact command is +shown in the status line. + + make colitur-mu && ./colitur-mu + +microui (MIT, rxi) is **vendored** in `vendor/`, 1504 lines. That is the point: +a copied-in dependency cannot rot. `mu_x11.c` is the Xlib/Xft backend, ~150 +lines — microui emits a command list and asks two font-metric questions; this +answers them. + +### One bug worth recording + +microui resets its scissor by emitting an "unclipped" rectangle of +`0x1000000` × `0x1000000`. `XRectangle`'s width and height are **unsigned +short**, so that truncates to **0** — turning "clip nothing" into "clip +everything". The symptom is that a scrolling panel draws its first screenful +and everything after it silently disappears, which looks like a layout or +buffer-overflow bug and is neither. `set_clip()` clamps to the buffer bounds +before converting. + +### Which to use + +`colitur-x` renders; `colitur-mu` renders and lets you change the invocation. +Neither is the right answer for a non-technical user on a machine that is not +yours — both are X11-only and must be compiled. For that, a static site or a +small local web UI wins. |