Argtype descriptions name a literal parameter's cost, a phase's error is the phase's report, the ^-code table's grave-accent and dieresis rows (from dev ee86ca467512)

This commit is contained in:
ack committed 2026-10-18 23:19:37 +02:00
1 parent f4dcdf3ffd
commit 35ca469e4d
7 files changed
+66 -6

No files matched your search

+16 -2
View File
@@ -87,7 +87,18 @@ std::vector<std::tuple<std::string, std::string, std::string, std::string, modif
R"((?:.|\n)*)", R"((lambda s : __import__("kutil").rest_split(s, N)))",
nullptr },
{ "literal", "literal text passed without interpretation",
// A description is Klammertext source (desc.klammertext in
// Argtype_registry::parameters()), rendered by ref/ for kdesc --argtypes:
// a special it mentions is caret-quoted (^@c), and it is one line, since
// the programmer's dump (kdiag --machine) shows the first line only.
// kdesc --argtypes is where klammertext_description.md sends a reader
// for the argtypes, so the practical consequence of declaring a literal
// parameter -- the named close -- is stated here, not only on @c
// (TODO 76, 2026-10-13).
{ "literal", "literal text passed without interpretation; a klammer with a "
"literal parameter (always its last positional one) is closed by its "
"name, as ^@c ... c^@ is, because the content may hold ^@ and the end "
"cannot be found by counting",
R"((?:.|\n)*)", "str",
pyformat_string },
@@ -97,7 +108,10 @@ std::vector<std::tuple<std::string, std::string, std::string, std::string, modif
// has its "^" forms processed as the value is built, this keeps them:
// "^@date" stays "^@date", so it re-reads as the text "@date" rather
// than as a klammer application. (2026-09-13)
{ "klammertext", "Klammertext source, kept exactly as written",
{ "klammertext", "Klammertext source, kept exactly as written, for a "
"description a Machine renders later: unlike literal, the quoting "
"carets are kept, so a quoted klammer stays quoted when the text is "
"read again, and no named close is required",
R"((?:.|\n)*)", "str",
pyformat_string },
};