Answer prose round 3: the CHANGELOG list reads on one pass and names --separator, the JSON-string clause says what the escapes do, and the weight refusals are separated

This commit is contained in:
2026-10-08 12:34:18 +02:00
committed by Lillem4n
parent 48e2b1ce9f
commit 221ce82e43
3 changed files with 9 additions and 9 deletions
+7 -7
View File
@@ -36,14 +36,14 @@ replacement, and each removed path, column or flag.
nothing piped in, exits 2; an empty or blank stdin is a format string, and renders as nothing piped in, exits 2; an empty or blank stdin is a format string, and renders as
sent. sent.
- A template or data file loads whatever is well-formed and means one thing, even where - A template or data file loads whatever is well-formed and means one thing, even where
part of it does nothing: a default written out, a one-item choice, an object holding only part of it does nothing: a default written out; a one-item choice; an object holding only
a format, a constant sample such as `{int(5,5)}`, a `weight`, `separator` or `datatype` a format; a constant sample such as `{int(5,5)}`; a `weight`, `separator` or `datatype`
where it does nothing, a name nothing reads, a repeated item, which counts as written, a where it does nothing; a name nothing reads; a repeated item, which counts as written; a
weight of `0`, which is never drawn, a `repeat` or count of `0`, which renders nothing, weight of `0`, which is never drawn; a `repeat` or count of `0`, which renders nothing;
`+5`, `05` and `-0`, and a reference into the category it sits in. A rows file no `+5`, `05` and `-0`; and a reference into the category it sits in. A rows file no
category names is ignored. `New` with no data loads, and renders templates that read category names is ignored. `New` with no data loads, and renders templates that read
none. The CLI's `-n` takes `0`; `--list` ignores `--repeat`, `--format` and `--table`, none. The CLI's `-n` takes `0`; `--list` ignores `--repeat`, `--separator`, `--format`
and `--table` is ignored without `--format sql`. and `--table`, and `--table` is ignored without `--format sql`.
- Table categories: a category JSON naming a `rows` TSV beside it, with the options - Table categories: a category JSON naming a `rows` TSV beside it, with the options
`key`, `name`, `weight` and `parent`; a path selects a row by key or name, `key`, `name`, `weight` and `parent`; a path selects a row by key or name,
`misc.territory[SE]`, and descends to a linked table by name, one path drawing each `misc.territory[SE]`, and descends to a linked table by name, one path drawing each
+1 -1
View File
@@ -438,7 +438,7 @@ writing it as `{ "format": "AB", "weight": 3 }`. A repeated item counts as writt
so `["a", "a", "b"]` draws `a` two times in three, and an item of weight `0` is never so `["a", "a", "b"]` draws `a` two times in three, and an item of weight `0` is never
drawn. A weight outside a choice does nothing, and so does one above `0` on the item of drawn. A weight outside a choice does nothing, and so does one above `0` on the item of
a one-item choice. Rejected at load: a weight that is negative, not a number, or too a one-item choice. Rejected at load: a weight that is negative, not a number, or too
close to `0` to tell from it, such as `1e-400`, and a choice whose every weight is `0`, a one-item choice of weight `0` among them. close to `0` to tell from it, such as `1e-400`; and a choice whose every weight is `0`, a one-item choice of weight `0` among them.
### Repeat ### Repeat
+1 -1
View File
@@ -66,7 +66,7 @@ valid JSON so a stray copied bracket never swallows a tag — it names nothing,
so. Reserving the characters whole — though only a leading one so. Reserving the characters whole — though only a leading one
could collide — keeps one simple name rule instead of a leading-position special case. could collide — keeps one simple name rule instead of a leading-position special case.
A JSON string stays a template even where its bare text renders alike, `"x {/a}"` beside A JSON string stays a template even where its bare text renders alike, `"x {/a}"` beside
`x {/a}`: inside the quotes `\t` and `\n` write a tab or a newline on one line. A `x {/a}`: inside the quotes, `\t` and `\n` let a one-line template write a tab or a newline. A
folder-relative `{.name}` or `{..name}` is refused naming folder-relative `{.name}` or `{..name}` is refused naming
`{/name}`, since an inline template sits in no folder. `IsTemplate` exports the rule, so `{/name}`, since an inline template sits in no folder. `IsTemplate` exports the rule, so
struct tags and any other caller read one. struct tags and any other caller read one.