Target coverage: a klammer states the targets it serves
kdesc gains --coverage, which reports for every klammer the set of targets it can render to, and — the point of it — which klammers' coverage cannot be derived and must therefore be declared. Three rules: coverage is DERIVED where the definitions determine it (a general body of klammer calls covers the intersection of what those klammers cover, by a greatest fixpoint after loading), DECLARED where the engine cannot interpret what decides it (an @eval body, whose targets are undecidable), and UNKNOWN where nothing is written — which never means "deliberately unavailable". Two new spellings in a definition's name. A comma-separated target list, "@@table.html,tex :: ...", gives one body several targets; it is surface syntax, expanded at registration, and each member goes through the redefinition rules on its own. And "@@date.* :: ..." writes the general target out, asserting that the klammer works for EVERY target including ones not yet defined — a stronger claim than a list of the targets defined today, and the one target declaration that could be mechanically falsified. The Standard Klammer Set was swept accordingly: it now has no general definitions at all, every klammer names the targets it serves, six use ".*", and tex and pdf are at zero undecided. kdesc's flags are reorganised on two rules: a flag reached for often gets a single letter (-k klammers, -t targets, -c characters, -i input), a more specialised topic a multi-letter name (--argtypes, --katoms, --rewrite, --optionsets, --coverage, --klammerset, --font); and -v says how much to show about PROCESSING, never what the RESULT contains — so the katom regex column is "--katoms full" and the coverage detail "--coverage all". NOTE: "-k" now lists klammers (optionally filtered by a name/description search); the katom table moved to "--katoms". Fixes carried along: an option written with no value crashed the command with SIGSEGV instead of reporting the mistake; two required positional arguments never parsed; kdesc and kdiag printed an error and exited 0; and definition diagnostics counted registrations rather than what was written, so one line could be reported as two definitions and then printed twice. Four new test suites: target_list, coverage, command_option, kdesc. (from dev 46f54080bd9a)
This commit is contained in:
@@ -4,62 +4,13 @@
|
||||
@@@
|
||||
|
||||
@@ul.k list_items.rest :cmp.bool false :bullet : Unordered list, with list elements preceeded by the *bullet* character. @@
|
||||
@@ul :: @eval list.List(K, "ul") eval@ @@
|
||||
@@ul.html,tex,txt :: @eval list.List(K, "ul") eval@ @@
|
||||
|
||||
@@ol.k list_items.rest :cmp.bool false :initial.int 1 : Ordered list, with numbered list elements. @@
|
||||
@@ol :: @eval list.List(K, "ol") eval@ @@
|
||||
@@ol.html,tex,txt :: @eval list.List(K, "ol") eval@ @@
|
||||
|
||||
@@define descriptions.rest(2) :font i : @eval list.Define(K) eval@ @@
|
||||
@@define.k descriptions.rest(2) :font i : A list of words or phrases and their definitions or descriptions @@
|
||||
@@define.html,tex :: @eval list.Define(K) eval@ @@
|
||||
|
||||
@@columns items :n.int 2 : @eval list.columns(K) eval@ @@
|
||||
##
|
||||
|
||||
#[
|
||||
@@@category list ul ulc ol li define item
|
||||
:desc Ordered and unordered lists; definitions of terms @@@
|
||||
]#
|
||||
|
||||
|
||||
#[
|
||||
@@describe descriptions.rest : @eval list.describe(K) eval@ @@
|
||||
@@entry item | description : @eval list.entry(K) eval@ @@
|
||||
]#
|
||||
|
||||
#[
|
||||
@@ul.doc list_items.rest :cmp.bool false :bullet square :itemsep :uncover.bool :indent.bool true :parsep 6pt :margin 8pt :in_define.bool : Unordered list @@
|
||||
@@ul : @eval list.ul(K) @ @@
|
||||
|
||||
@@ol.doc list_items.rest :cmp.bool false :itemsep :uncover.bool :parsep 6pt :margin 8pt :in_define.bool : Ordered list @@
|
||||
@@ol : @eval list.ol(K) @ @@
|
||||
|
||||
@@li.doc s :keep.bool : List item @@
|
||||
@@li : @eval list.li(K) @ @@
|
||||
|
||||
@@dfont :s : @eval list.dfont(K) @ @@
|
||||
|
||||
@@define.doc s :font r :uncover.bool : List of definitions @@
|
||||
|
||||
@@define : @eval list.define(K) @ @@
|
||||
|
||||
@@item.doc term desc :c.bool false :inlist.bool false : Definition of @i-term is @i-desc @@
|
||||
|
||||
@@item term desc :
|
||||
@eval list.definition_item(K) @
|
||||
@@
|
||||
|
||||
@@mli args.rest : @eval list.mli(K) @ @@
|
||||
|
||||
@@ncircle.latex n : \circled{*n*} @@
|
||||
|
||||
@@dblitem.latex a | b | desc :
|
||||
\item[\parbox{\linewidth}{*a* \\ *b*}]
|
||||
\leavevmode \\[-5pt]
|
||||
*desc*
|
||||
@@
|
||||
|
||||
@@dblitem.html a | b | desc :
|
||||
<dt>*a*<br>
|
||||
*b*</dt>
|
||||
<dd>*desc*</dd>
|
||||
@@
|
||||
]#
|
||||
@@columns.k items :n.int 2 : Create two or more columns from the text @@
|
||||
@@columns.tex :: @eval list.columns(K) eval@ @@
|
||||
|
||||
Reference in New Issue
Block a user