diff options
| author | Danilo M. <danix@danix.xyz> | 2026-09-17 12:40:13 +0200 |
|---|---|---|
| committer | Danilo M. <danix@danix.xyz> | 2026-09-17 12:40:13 +0200 |
| commit | adecc8de0e90b3856c8807e1c3610c70879545ad (patch) | |
| tree | a530c9e19a7b03b73f0526c9e62cf00ba17e607e /docs | |
| parent | 32e10b1d6962afd04a209f300ebb8ab9ee29f070 (diff) | |
| download | conky-theme-udt-adecc8de0e90b3856c8807e1c3610c70879545ad.tar.gz conky-theme-udt-adecc8de0e90b3856c8807e1c3610c70879545ad.zip | |
docs: correct the system-widget comments and defer the age marker
Fix the conky.conf.in comment to name all three samplers and the README
to say the cache sampler runs every 15 minutes. Rewrite the disks layout
comment to match per_row = n (no wrapping), drop the stale "seventeenth
bar" note, and record in the spec that the cache age marker is
deliberately deferred with the epoch-line upgrade path.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/superpowers/specs/2026-09-17-system-widgets-design.md | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/superpowers/specs/2026-09-17-system-widgets-design.md b/docs/superpowers/specs/2026-09-17-system-widgets-design.md index 9fee4a5..cd24ee0 100644 --- a/docs/superpowers/specs/2026-09-17-system-widgets-design.md +++ b/docs/superpowers/specs/2026-09-17-system-widgets-design.md @@ -239,6 +239,18 @@ crashed widget. beside the heading, so an unreachable NFS server or a dead sampler is visible rather than silently showing yesterday's numbers. +> **Implementation note (deferred): the age marker is not drawn.** The +> requirement above is deliberately unimplemented in this wave. The cache +> formats and their parser fixtures are fixed by the plan, and the widgets +> already implement the absent-file case (`no cache data` plus the sampler +> name). Adding the marker means either embedding an epoch timestamp in each +> cache file, which would disturb every fixture and the two parsers, or +> stamping the file's mtime, which conky's Lua cannot stat: `lfs` is not +> available in the environment. The accepted path when it is picked up is an +> extra epoch line that the parser learns to skip, leaving the existing fields +> and fixtures untouched; the widget then compares it against the sampling +> interval and draws a dim age marker beside the heading. + ## Tests `test/test_data.lua` extends with fixtures under `test/fixtures/`: |