diff options
| author | Ralph Amissah <ralph.amissah@gmail.com> | 2026-09-21 10:04:40 -0400 |
|---|---|---|
| committer | Ralph Amissah <ralph.amissah@gmail.com> | 2026-09-22 14:08:10 -0400 |
| commit | a32230d9ede2cf3a4f85547e6793b8918c72af30 (patch) | |
| tree | 6ec0c07713f6c84f5bcbc5414fb376f9b493c654 /org/in_abstraction_artefacts.org | |
| parent | pod: set entry limit for the writer and reader (diff) | |
pod: carry tools/po4a, the translation working set
A pod now carries its catalogues, so a translation can be updated
rather than only retyped: providing the .pot and .po (the means of
maintaining it).
A directory walk, where every other thing the pod writer carries is
named. A catalogue set is whatever the translator has, and enumerating
.pot and .po files would mean the writer deriving the document's
languages a second time, from a second place, to say what it already
reads from the manifest.
Done once, on the last language, as the markup blocks are. The tree is
not language specific, so a pass for each language would re-read all of
it, 5.5 MB ten times over for live-manual, into an archive the next pass
overwrites.
Every name is checked before it is carried, by the rule the pod reader
applies to an archive it is handed. The writer is reading a directory
someone else may have filled, which is the reason the reader checks.
The cost is small, and it is the whole argument for compressing the
archive as a stream rather than per member:
uncompressed content 6972418 -> 13167489 +89%
the .sisupod 692942 -> 891388 +28.6%
5.5 MB of catalogues cost 198 KB, because the .po files largely repeat
markup already in the archive and whole-stream compression sees it.
Per-member deflate could not.
(assisted by Claude-Code)
Diffstat (limited to 'org/in_abstraction_artefacts.org')
0 files changed, 0 insertions, 0 deletions
