Andy Kopra
59c1599bc9
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)
63 lines
1.7 KiB
Plaintext
63 lines
1.7 KiB
Plaintext
#[
|
|
@@@state image_search_path.list :create Series of directories for image search
|
|
:value . imgsrc ../imgsrc ../dbg
|
|
@@@
|
|
]#
|
|
|
|
@@@state Image_search_path :desc Series of directories for image search
|
|
:value . imgsrc ../imgsrc ../dbg
|
|
@@@
|
|
|
|
@@@state Image_output_dir :desc Output directory for images :value img @@@
|
|
|
|
@@@state Image_default_width :desc Default width for images :value .667w @@@
|
|
|
|
#
|
|
# @@@argtype pixels | a pixel count :pattern \d+px @@@
|
|
# @@image.k basename : Image read from a file @@
|
|
# @@image.html basename | width | height : @eval import image ; result = image.image(K) eval@ @@
|
|
|
|
# An image once had its own position type, for the sake of the "none" value
|
|
# (no positioning container). That value is meaningful for any block
|
|
# element, so the shared hpos type carries it and an image is placed by the
|
|
# hpos_args option set like every other block element.
|
|
|
|
@@image.k
|
|
basename
|
|
:id
|
|
:width.length .5w
|
|
@caption_args@
|
|
:vmargin.bool true
|
|
@hpos_args@
|
|
:rel
|
|
:abswidth.number 0.0
|
|
:border.bool false
|
|
:
|
|
An image read from a file. The basename names the file, which is looked
|
|
for in the image search path and converted to a format the target can use.
|
|
^:width is the image's width in the text column, ^:hpos and ^:offset place
|
|
it there, and the caption arguments caption it.
|
|
@@
|
|
|
|
@@image.html,tex :: @eval image.Image(K) eval@ @@
|
|
|
|
@@image_grid.k
|
|
image_specs.rest(2)
|
|
:cell_number.bool false
|
|
:landscape.bool false
|
|
:scale.number 0.98
|
|
@caption_args@
|
|
@hpos_args@
|
|
:thumbnail.bool false
|
|
:allow_break.bool true
|
|
:id
|
|
:rel
|
|
:hsep.number 0.02
|
|
: A grid of images
|
|
@@
|
|
|
|
@@image_grid.html,tex :: @eval image_grid.Image_grid(K) eval@ @@
|
|
|
|
@@fig.k spec.figure_id : The caption title for a figure @@
|
|
@@fig.html,tex :: @reference *spec* | Figure @ @@
|