tclpdf

Timeline
Login

Timeline

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

50 most recent check-ins

2026-11-09
18:46
Keep export values, link addresses, XMP texts and font aliases as text

- fieldButton: the export value of a check box and the chosen value of a radio group no longer pass through an expr ternary - /V, /DV, /AS and the appearance state agree for a value of digits such as 01 or 010
- textRun: a link address of digits reaches /URI as written, from runs, tags, Markdown and table cells
- xmp: Keywords, Creator and the creating tool say the same text as the Info dictionary
- field: a face embedded under an alias of digits is embedded whole for a fillable field
- page: the refusal of -fit and -fitMode names the value as the caller wrote it
- tests: fieldButton-33.1 to 33.3, textRun-7.10, xmp-7.7 and 7.8, field-8.12, page-fitcheck-12.11
- textRun 1.4, xmp 1.8 leaf check-in: 2093c9ce05 user: alex tags: trunk

08:06
Keep field names, export values and options as text in pdf fields

- importInfo: a field name, the selected state of a check box or radio button and both halves of an /Opt entry no longer pass through an expr ternary - a name of digits such as 01 or 010 and a name such as 1.10 come back as written
- xml: an entity value in the amplification guard is taken as written the same way
- tests: importFields-33.1 to 33.4, svg-r8-75.4 check-in: 48baf77b81 user: alex tags: trunk

07:51
Pin the DocMDP refusal for a /P written with a leading zero

- tests: importDecimal-9.1 - a file certified with /P 01 is refused by sign add as /P 1 is, and /P 02 takes a further signature check-in: aa578edf09 user: alex tags: trunk

2026-11-07
09:45
Replace entity references without subst in the pure Tcl XML parser

- xml: Unescape replaces each reference in one pass over the text; the text between references is copied, never evaluated, so a bracketed command inside an attribute or text node no longer runs - closes command execution from a foreign SVG when tdom is absent
- xml: the digits of a numeric character reference are read with scan, so a leading zero no longer makes Tcl 8.6 read them as octal
- tests: svg.test covers the bracket case, literal backslashes and dollar signs, numeric references with leading zeros, a double-escaped reference, and the agreement of both parsers check-in: 9fd8236a60 user: alex tags: trunk

09:09
Read leading zeros in decimal: SVG, colour components, font files, hyphenation files, XML attributes

- svgPath: one number grammar for the module, new readers numbers and length; the tokenizer reads arc flags before the number that follows them - svgElement and svgPaint read lengths, coordinates and paint values through it
- color: components and the single-number grey form are read in decimal before they are checked
- type1 and sfnt: integer and CFF real operands of the font programs are read in decimal
- hyphenate: the four *HYPHENMIN directives of a pattern file are read in decimal
- xml: an attribute value is no longer passed through an expr ternary, so the pure Tcl parser hands it on as written like tdom does
- tests: fileDecimal.test new, decimal.test extended, byte-comparison helpers moved from font.test into helper.tcl - example 03.11-leading-zeros-svg new
- manual: colour components under coordinates and units, SVG lengths and numbers read in decimal
- module versions raised, minimum versions pinned where a caller needs the new reading check-in: b7ef4884fa user: alex tags: trunk

2026-11-06
23:47
Read the numbers of a foreign PDF with a leading zero in decimal

- importRead: a number token loses its leading zeros where Parse reads it, after the grammar check of 7.3.3 - every consumer of a number object comes through there, so /Count, the boxes, /Rotate, /Ff, /I, /ByteRange, /Size and the predictor and fax parameters read alike under Tcl 8.6 and Tcl 9; Decimal reads through pdfObj decimal
- update: an object number a caller hands to defines, release, put, replace, ref or body is read in decimal
- importRead 1.7, importInfo 1.6, update 1.5; import, sign and timestamp require them
- tests/importDecimal.test new; import-24.21 expects the number read; examples/06.04-leading-zeros-import.tcl new - a hand-written foreign file with zeros, imported and checked
- manual: the fourth reading under what travels, and the bytes-untouched sentences name it
- knowingly: a copied object carries 10 where the file wrote 010; DocMDP /P 01, /EarlyChange 01 and /BitsPerComponent 08 are read right through the same gate without a change at their checks; overprint -mode 01 is still refused check-in: 96f06ee3c1 user: alex tags: trunk

22:04
Cheaper leading-zero reading on the hot paths

- geometry toPoints, option number, page PageIndex, pdfObj num and text TextCheck call the decimal reader only for a value that begins with a zero and a digit
- option decimals filters the named keys first instead of matching the whole options dictionary check-in: 97f1703966 user: alex tags: trunk

21:56
Read numeric options with a leading zero in decimal under Tcl 8.6 and Tcl 9

- pdfObj: new reader decimal - a plain decimal literal loses the leading zeros of its integer part, everything else (0x1A, 0o17, NaN, 1e3, words) passes through unchanged; num and written read through it
- option: point, number and zoom read in decimal and return the value read; new helper decimals reads the numbers of an options dictionary, nested lists included
- geometry: toPoints and check read in decimal, check returns the matrix read
- integer options read in decimal at their check: -page, -face, -index, -total, -from/-start, -maxlen, -left/-right/-min, -axes, -numCopies, -part, -rotate and the options of sign, timestamp, structure and type3
- page: box returns the box as read; text: TextCheck returns the value read and font/TextMerge keep it
- font, colorFont: the FACE error codes quote the value as written
- minimum versions raised where a caller relies on the new reading (geometry 1.8-, option 1.4-, pdfObj 1.9-, document 1.17-, field 1.4-, tableLayout 1.11-, font 1.20-, type3 1.5-); 41 modules raised by 0.1, pkgIndex.tcl.in follows
- tests/decimal.test new; examples/00.04-leading-zeros.tcl new - the same page drawn with and without leading zeros, content compared
- manual: one sentence under Coordinates and units
- not in this change: colour components, numbers read from foreign PDFs, SVG, font and hyphenation files, and the text comparisons on DocMDP /P, /EarlyChange, /BitsPerComponent and overprint -mode check-in: 8b6b2ed030 user: alex tags: trunk

2026-11-01
10:37
Version 1.7.2

- configure.ac and tclpdf.tcl carry 1.7.2, the manual synopsis follows; configure regenerated by autoconf check-in: 18f0fa3f95 user: alex tags: trunk, release, version-1.7.2

10:16
Makefile.in keeps the TEA copyright notices

- the header carries the Scriptics and ActiveState lines of the TEA sample it derives from, pointing at tclconfig/license.terms check-in: 9594fb8dbc user: alex tags: trunk

09:52
Licence notices after the audit, part two: the pandoc template and OCR A

- doc/tclpdf-default.html names pandoc's default template it derives from, with John MacFarlane's copyright and the BSD-3-Clause text, in a comment that reaches the generated HTML manual
- OCR-LICENSE.txt quotes Richard B. Wales' terms for the OCR A base, the third statement it had announced; the asset README names the no-fee clause
- examples/assets/README.md: the origin table carries the fonts' own copyright years and rows for Arimo, Permanent Marker and the Noto faces
- knowingly open: the Noto Color Emoji licence file says 2021, the font 2022, not compared against upstream check-in: 9a0e7abc29 user: alex tags: trunk

2026-10-29
10:50
Version 1.7.1

- configure.ac and tclpdf.tcl carry 1.7.1, the manual synopsis follows; configure regenerated by autoconf check-in: 0318611fc3 user: alex tags: trunk, release, version-1.7.1

10:25
timestamp.test: cut the token by its DER length, not by trimming zeros

- the trim took the token's own last nibble one time in sixteen, and the short token failed openssl's verification by chance on either interpreter check-in: 7df120b5e7 user: alex tags: trunk

10:09
Licence notices for the third-party data the package ships, after the provenance review

- afmData, bidiData and joiningData carry the terms of their sources in the header: Adobe's permission paragraph and trademark notices for the core font metrics, the Unicode License v3 for the character database tables - written by tools/mkafm.tcl, mkbidi.tcl and mkjoining.tcl, which regenerate the modules byte for byte; the Unicode text also as tools/ucd/LICENSE
- tclconfig/license.terms: the Tcl licence for the TEA files, tests/all.tcl and the Tcl 9 logo, which pointed at the package's own MIT file
- tools/mkversion.tcl names Fossil's mkversion.c and carries its BSD-2-Clause notice
- README and examples/assets/README.md: what MIT covers and what icc/ carries, the generated data modules and their sources, the FeRD sample invoices under FeRD's own terms, the specimen portrait; urw-core35 NOTICE.md states the measured fsType per face
- example 02.09 prints the Apache 2.0 notice for Permanent Marker, whose subset carries no name table
- hyphenate.tcl: the comment on comment lines in a .dic file says what libhyphen actually skips check-in: f144958ae7 user: alex tags: trunk

2026-10-16
18:30
Version 1.7

- configure.ac and tclpdf.tcl carry 1.7, the manual synopsis and its header follow, the list-in-a-cell paragraph says since 1.7; configure regenerated by autoconf
- manual: the optional packages name http and tls, loaded for a document timestamp
- skill and doc/claude/TCLPDF.md: cell keys runs and markup, style key markup, hook keys hyphens and listed, lists in a cell marked 1.7, traps for a heading in a cell and a list in a decimal column; a table rule in the prompt
- README names lists in table cells check-in: 9ba4e3def9 user: alex tags: trunk, release, version-1.7

17:57
Lists in table cells: bullet and numbered items as runs, tags or Markdown

- tableLayout: a cell of runs may carry item, start and continued; only heading is still refused as a paragraph of its own size - a cell holding a list is marked listed
- tableDraw: a listed cell is drawn in one text call with the table's leading and hyphenation, so indent, label and numbering come from the paragraph code; every other cell keeps the line-by-line path unchanged
- textBlock: TextLinesWidest measures a list at full width and adds its indent, so an automatic column holds the list without a break
- textRun: a list paragraph drawn while structure is suspended or inside an artifact writes its marks but opens no L or LI - repeated head and foot rows, forms and patterns no longer leave empty list elements in the tree
- versions: tableLayout 1.10, tableDraw 1.9, textBlock 1.21, textRun 1.3, table 1.13, with the minimum versions along the chain
- tests: table 28.1-28.11 (height, baseline, numbering past ten, markdown and tags against runs, natural width, valign, tagged tree, ua 1 with veraPDF, list in a repeated head, refusals), structure 11.5; example 04.05 gains a bullet and a numbered list; manual and skill follow
- knowingly open: a column narrower than the indent of its list is refused with TCLPDF TEXT INDENT width, not with a table code check-in: e19bcb438c user: alex tags: trunk

2026-10-04
18:20
README rewritten: short, current, pointing to the manual and the wiki

- README: one line per feature area up to 1.6 - runs and markup, form fields, signatures and timestamps, import, layers, colour fonts, encryption - in place of the long description
- dependencies corrected: http and tls are loaded for a document timestamp
- licence block names the contributors: special thanks to Ralf Fassel check-in: 8bbc5be340 user: alex tags: trunk

2026-10-02
18:58
Version 1.6.1: a changed module carries a new version, and a release is checked for it

- io 1.3, text 1.26, textBlock 1.20, sign 1.8, structureDest 1.2 - each had changed since an earlier release under the number it carried there, so two installed releases side by side loaded the older file under the newer package; a table cell of runs then failed on a method the older textBlock lacks
- tableLayout 1.9, tableDraw 1.8, table 1.12, text, timestamp 1.1 - require the version of the module whose new code they call, so a mixed installation fails at the load
- tests/release.test (new) - the same module version means the same content, across every release tag; and two releases side by side in auto_path load the files of the newer one and set a cell of runs
- configure.ac and tclpdf.tcl carry 1.6.1, the manual synopsis follows; configure regenerated by autoconf
- skill and doc/claude/TCLPDF.md: after an update, ask package ifneeded which directory a sub-package comes from
- knowingly open: release.test skips without fossil or outside a checkout check-in: 30d451f6e2 user: alex tags: trunk, release, version-1.6.1

06:06
Version 1.6

- configure.ac and tclpdf.tcl carry 1.6, the manual synopsis follows; configure regenerated by autoconf
- skill: 03-text.md says what a url run writes in a tagged document and when -breakHyphen may stand beside -width; 06-tables.md names the two markup refusals it lacked check-in: 09b0ee7c84 user: alex tags: trunk, release, version-1.6

2026-10-01
11:49
io: one road through open, closed on every exit - with thanks to Ralf Fassel for pointing it out

- io.tcl - read, head and write go through one private Transfer: open in try, trap POSIX, finally close, so a channel never stays open after a refusal; the refusal is sorted out AFTER open failed (Refuse: MISSING for a missing file on read, DIRECTORY for a directory on read and write) instead of a file check in front of open, and no POSIX name is matched; a close error of a write reaches the caller
- tests/io.test (new) - bytes round trip, head shorter, longer and of length 0, the refusals by code, and chan names before and after every call
- tools/check.sh - a failing test suite prints the failed tests with result, expectation and errorInfo and keeps the full output under /tmp; each interpreter gets a -tmpdir of its own
- knowingly open: writer.tcl opens its own channel with its own finally; a failed write leaves the truncated file behind as before; Windows unmeasured check-in: 00d961ef8d user: alex tags: trunk

2026-09-30
22:00
Table cells set as runs, and cells read as tags or Markdown

- tableLayout.tcl, table.tcl - runs is a cell key holding the pairs of text -runs 1, and markup a style key (plain, tags, markdown) said for the table, a section, a column or the cell; the string stays under text, and a translation that marks nothing leaves the cell plain - a cell of runs is measured line by line in its faces and the natural column width follows; refused by name: text beside runs, an odd list, runs beside markup, the pair form of markup, decimal on a body cell of runs, a heading or list item in a cell, and what a didParseCell hook hands back is checked like a written cell
- tableDraw.tcl - a line of runs is drawn by text -runs 1 with the width it was broken to and -breakHyphen for the flag the breaker gave it
- text.tcl, textBlock.tcl - -breakHyphen beside -width is admitted for runs only, and the string then has to stay one line (TCLPDF TEXT BREAKHYPHEN lines); TextLinesWidest measures the widest paragraph of a list of runs
- tests/table.test - table-27.1 to 27.18: baseline against the plain cell, height and natural width, every refusal, the hyphen bracket in a tagged cell, veraPDF UA-1 over three pages with the repeated head, hooks, the bytes of a plain table unchanged
- examples/04.05-table-markup.tcl (new) - a Markdown column, a cell of runs from data, a cell of tags, the refusals, and a fallback written as a hook
- doc/tclpdf.md - runs and markup under table, the markup style key, the hook dictionary, the -breakHyphen exception; the url sentence under -runs corrected: a url run writes the annotation only, no Link element and no Contents, so such a document cannot claim ua
- skill: 06-tables.md shows cells of runs and the markup key, SKILL.md names both cell keys
- versions: table 1.11, tableLayout 1.8, tableDraw 1.7
- knowingly open: a Link element and Contents for a url run; a heading or a list inside a cell is refused rather than set check-in: 4083d221a0 user: alex tags: trunk

2026-09-28
15:01
Version 1.5

- configure.ac and tclpdf.tcl carry 1.5, the manual synopsis follows; configure regenerated by autoconf
- example 01.17 says "since 1.5" for runs and markup, which are new in this release and not in 1.4
- skill: SKILL.md names sign timestamp under the signatures reference, and the fonts reference points at font family for a bold run on an embedded face check-in: 3da3371f2b user: alex tags: trunk, release, version-1.5

13:15
Lists in flowing text: bullet and numbered items in tags, in Markdown and as runs

- textRun.tcl, textBlock.tcl, text.tcl - a list item is a paragraph state like a heading: the runs carry item bullet or item number, the item is indented on every line and labelled in front of its first, the package counts the numbers; headings and items now share one paragraph table, which also gives the second paragraph of a two-line heading its heading leading; the rest of a height-limited block carries start and continued so that numbering and indent survive the cut; in a tagged document a list is L with ListNumbering holding LI, Lbl and LBody, and is refused beside -paginate and -columns
- markup.tcl - ul, ol and li; markdown.tcl - a line beginning with -, * or + or with a number and a full stop, the backslash also escapes -, + and .
- tests/textRun.test, tests/markup.test, tests/markdown.test - the state, the count, every refusal, the tagged tree against veraPDF, the same list from both notations, and the unchanged bytes of blocks without items
- examples/01.19-lists.tcl (new) - both notations as typed and as set; examples/common.tcl carries the typed-and-set page and the same-lines proof that 01.17 and 01.19 share
- doc/tclpdf.md - item, start and continued under -runs, lists under -markup tags and markdown; the skill's 03-text.md and SKILL.md show a list in both notations
- versions: textRun 1.1, textBlock 1.19, text 1.25, markup 1.2, markdown 1.1
- knowingly open: one level only, no nesting; a tagged list does not paginate; the label of a right-aligned or centred item stands at the left edge of the band check-in: 1b89818200 user: alex tags: trunk

05:48
Skill reference: runs inside a paragraph, and the check runs against the source tree

- reference/03-text.md - new section with tags, Markdown, the list of -runs 1, font family on an embedded face, three refusals shown by their error codes, and textLines/textHeight answering runs; SKILL.md names it
- assets.tcl and check.tcl put the source tree in front of auto_path, once, so that the snippets check the tree and not an installed copy of the same version check-in: 9231b254a0 user: alex tags: trunk

2026-09-27
22:11
Examples 1.17 and 1.18 cut along the rule of one thing per example

- 01.17-markup - the two notations, one page each, as typed and as set: the string in Courier without -markup, underneath the same string with -markup tags and with -markup markdown; the last line measures that both break into the same lines, the underline apart
- 01.18-runs (was 01.18-markdown) - the list underneath the notations, written by hand and set in an embedded family: font family, the refusal of a face the family does not have, and what the headings cost by textHeight check-in: d5f6877491 user: alex tags: trunk

21:20
Markdown as the second notation of -markup

- markdown.tcl (new) - text -markup markdown reads strong, em, both, strikeout, links and headings 1 to 3 into the same runs the tags become; read as strictly as the tags, with OPEN, NESTING, LINK and HEADING refusals naming the position; underscore is text, there is no underline, and the rest of Markdown is text rather than refused
- markup.tcl - the emit step is public and shared by both translators, so one vocabulary decides what a run is
- textBlock.tcl, text.tcl - -markup takes tags or markdown and loads the translator it needs
- tests/markdown.test (new) - the rules, every refusal, and the proof that the same paragraph in both notations gives the same list and the same content stream; runDoc moved into helper.tcl for the second test file that needs it
- examples/01.18-markdown.tcl (new) - the paragraph of 1.17 in Markdown and as tags, checked line by line with textLines
- manual: -markup markdown, the error code table regenerated; configure.ac, pkgIndex.tcl.in, tests/all.tcl carry the module; configure regenerated
- versions: markup 1.1, textBlock 1.18, text 1.24
- knowingly open: no code spans, a link address cannot hold a closing parenthesis, and a bracketed number in running text needs a backslash check-in: ea2b9be3d4 user: alex tags: trunk

20:31
Examples put the source tree in front of auto_path; 02.09 builds its astral characters from code points

- every example inserts the tree at the front of auto_path instead of appending it, so a run from the tree tests the tree whatever copy of the same version is installed; 00.01 says why
- 02.09-writing-systems: emoji, cuneiform, hieroglyphs and the music page are made from their code points by a codepoints helper; the file holds no character above the BMP any more. Tcl 8.6 decodes a four-byte UTF-8 character as four Latin-1 characters when its first byte falls one byte before a 4096-byte channel buffer boundary, so an edit further up the file decided whether the page could be drawn
- knowingly open: 02.18 and four test files still carry such literals check-in: d4105fe94f user: alex tags: trunk

20:29
Standard faces underline from their AFM; module versions after the runs check-in

- afmData.tcl regenerated from the Adobe AFMs in the tree: every descriptor carries UnderlinePosition and UnderlineThickness, nothing else changes; mkafm.tcl writes the module version it generates
- tests/afm.test checks the two keys, tests/textRun.test proves a standard face takes the AFM road and not the fallback
- font.tcl comment on FontDecoration says where the standard 14 get their values
- versions: text 1.23, textBlock 1.17, font 1.19, sfnt 1.12, afmData 1.2 check-in: d893e00ed8 user: alex tags: trunk

19:59
Runs in flowing text: bold, italic, underline, strikeout, links and headings inside a paragraph, with tags as the notation

- textRun.tcl (new) - text -runs 1 takes a list of {text options} pairs and sets each run in its own face: -style, -underline, -strike, -url, and -heading 1|2|3 as a paragraph of its own; the line breaker measures per piece, textLines and the rest of a height-limited block answer in the same shape, strokes and link annotations go onto the page after the block's mark
- markup.tcl (new) - text -markup tags reads b, i, u, s, em, strong, a href, h1 to h3 and p into those runs; ::tclpdf::markup::parse is the translator and knows no document
- text.tcl - font family registers the faces of an embedded family under one name so that -style reaches them; the rtl and ttb gates ask the resolved face; TextStateArguments and TextAlignUnknown hoisted out of their copies
- textBlock.tcl - the runs intake on every block road, table cells included; a leading per paragraph, a heading never the last line of a block, one structure element per paragraph in a tagged block, per-page flush of strokes and links in the paginating road
- sfnt.tcl, font.tcl - post underline and OS/2 strikeout read, FontDecoration answers them per face; tools/mkafm.tcl reads UnderlinePosition and UnderlineThickness for the descriptor table
- doc/tclpdf.md - text -runs and -markup, font family, textLines and textHeight, the error code table regenerated
- tests/textRun.test and tests/markup.test (new); tests/all.tcl and helper.tcl put the source tree in front of auto_path so the suite tests the tree whatever copy is installed; tests/order-x.xml added as the Order-X fixture of attach and zugferd
- configure.ac, pkgIndex.tcl.in and tests/all.tcl carry the two new modules
- knowingly open: afmData.tcl is not regenerated (the Adobe AFM source is sealed here), so a standard face underlines at the fallback fraction until mkafm.tcl is rerun; Strong and Em are carried as run flags, not yet written as inline elements; the examples follow in a check-in of their own check-in: c2e7f4d8b7 user: alex tags: trunk

2026-08-31
13:24
Version 1.4

- configure.ac and tclpdf.tcl carry 1.4, the manual synopsis follows
- configure regenerated by autoconf check-in: f551c12f1c user: alex tags: trunk, release, version-1.4

13:14
Document timestamps: new module timestamp.tcl, examples, tests, shared signing helpers

- timestamp.tcl - ::tclpdf::sign timestamp appends an RFC 3161 document timestamp (/Type /DocTimeStamp) to a finished file; no signature required, the authority is configurable through -url or a -tsa transport prefix, and the reply's digest, nonce and status are verified before the file is touched
- sign.tcl - FieldName and Ranged hoisted out of sign::add as shared private procs, used by add and timestamp alike
- tests/timestamp.test - network-free suite against a local openssl ts authority with mutation counter-proofs; sign-9.3 follows the grown ensemble message
- examples 08.06 to 08.08, simple to involved: the minimal stamp, the stamped PDF/A archive file, and a signed file stamped on top; without network they fall back to a throwaway authority and say so on the console
- examples/common.tcl - shared timestamp scaffolding; the reachability probe now honours the port in the URL and detects a refused connect
- tools/check.sh - the pdfsig section knows document timestamps and checks their coverage instead of skipping stamped files as unfilled placeholders
- manual and skill reference document the call; configure.ac, pkgIndex.tcl.in and tests/all.tcl carry the new module check-in: d09d9bafb8 user: alex tags: trunk

2026-08-27
23:39
Download page: the label column no longer wraps

- uv/template-download.html - white-space nowrap and top alignment on the three label cells (tclpdf VERSION, source code, tdom), so the generated download.html keeps "tclpdf 1.3" and "source code" on one line check-in: 456b2e4724 user: alex tags: trunk

22:46
Skill reference: a structureResume snippet and -min on hyphenate load

- doc/claude/skills/tclpdf-tcl/reference/09-tagged-ua.md - a Sect resumed on a second pass takes a further child, and resuming a leaf is shown refused as TCLPDF STRUCTURE PLACE leaf; every call the manual describes has a snippet again
- doc/claude/skills/tclpdf-tcl/reference/03-text.md - the hyphenate load call names -min, the shortest word broken at all check-in: 2521448eab user: alex tags: trunk, release, version-1.3

22:39
Version 1.3; the four decisions of round 8 named in the manual, an unknown path letter reported, the shipped profile found through a link, the suite run in its own directory

- configure.ac, tclpdf.tcl, configure - the package is 1.3
- doc/tclpdf.md - a fillable field overrides an explicit -subset 1 on its face, and says so; a mask whose data fail only while its streams are built leaves the ICC profile of its carrier as an unreferenced object, and says so; package require tclpdf 1.3
- svgPath.tcl - a command letter the path grammar does not know ends the path where it stands and is reported through svg info like a missing coordinate (SVG 1.1, 8.3.9); the tokenizer used to match the ten known letters only, so an unknown one vanished and its numbers went to the command before it
- pdfa.tcl - the shipped ICC profile is recognised through a symbolic link or a relative path, so its identifier stays sRGB IEC61966-2.1
- tools/check.sh - make test runs with -tmpdir in a directory of its own, so no fixture stays in the working directory
- tests - svg-2.10 with its mutation proof; pdfa and svgPath raised one minor step check-in: c9286403a3 user: alex tags: trunk

22:03
Norm review round 8 built: object generations kept, one extension schema bag, transactional structure scripts, marks on the right ligature component, SVG transforms the right way round, rotation about the point named

- importRead.tcl, import.tcl, importInfo.tcl, update.tcl, filter.tcl - an object is identified by number and generation through parsing, resolution, copying, update and serialisation; a reference to a generation the file does not have is the null object and a null value is a missing entry; the header of an object stream is checked against the cross-reference table; literal strings read end-of-line as LF and cap an octal escape at a byte under Tcl 8.6 and 9 alike; ASCII85 and ASCIIHex refuse characters outside the encoding; the last of two equal dictionary keys wins and only one is written; every leading zero goes through one decimal reader; an integer beyond 2^31 is serialised as a real; an imported page raises the version to what its source claims and is refused where the document cannot follow; a layer only an XObject refers to reaches OCProperties; the Artifact brackets of an imported page are stripped with its marked content; a Flate stream is bounded at 64 MiB
- xmp.tcl, zugferd.tcl, attach.tcl, sign.tcl - every pdfaExtension contribution is merged into one schemas bag at packet build; a caller's whole metadata packet beside a claim that needs registered schemas is refused by name; the XRECHNUNG profile embeds as xrechnung.xml and the reserved hybrid names cannot be taken twice; sign add reads the catalogue /Version beside the header, bounds -size on the value written and tokenises /ByteRange
- structure.tcl, structureReport.tcl, ua.tcl, link.tcl - structure -script rolls back element, children, names and ids when the script fails before it marked anything, with the content stream as the commit boundary; a -tag inside an open LI is kept or refused instead of becoming LBody; PDF/UA-2 refuses two targets in one Link element, a FENote without its Ref pair, a page destination and a second or misplaced Caption in every element Table 372 names; a link inside a form script is refused
- text.tcl, gsubApply.tcl, markPos.tcl, forms.tcl, font.tcl, subset.tcl, varFont.tcl, colorFont.tcl, morx.tcl, sbix.tcl, kernGpos.tcl - a glyph without a code point stays in its predecessor's cluster; MarkToLigature and MarkToMark attach through the component index the run now carries; ToUnicode gives a character its own CID where two share a skeleton glyph; Apple Color Emoji folds a GPOS-attached glyph into the Type 3 glyph of its base and deduplicates by text and glyph; vertical metrics of a variable instance come from gvar; an ill-formed variation region ignores its axis
- annot.tcl, annotShape.tcl, field.tcl, fieldText.tcl, fieldChoice.tcl, fieldButton.tcl - an annotation inside a form script is refused before anything is written; seven keys check their PDF version through one table; a fillable text or choice field embeds its face whole; a field's structure element is opened only after its widget is checked and rolled back on a later failure; sizes and border widths of every field type are checked at the call
- textBlock.tcl, textAvoid.tcl, leader.tcl, pageLabel.tcl, pageNumber.tcl, document.tcl, table.tcl, tableLayout.tcl - no space glyph after a break hyphen in tagged text; -avoid ends at the foot of the page and leader -width is bounded, so neither loops; pageLabels -start stays an integer; -typeArea and table -at are checked at the call; a colSpan across a -horizontalBreak group is refused; every public method is in the lazy-loader table and a test calls each as the first call of a fresh document
- svg.tcl, svgPaint.tcl, svgElement.tcl, svgPath.tcl, svgClip.tcl, xml.tcl - rotate and skew as SVG 1.1 says; switch, visibility, display in style, currentColor, stroke-width 0, nested viewports, one-stop and unsorted gradients, href inheritance, elliptical radial gradients in objectBoundingBox, stop-opacity reported, tspan in document order, units, miter limit, dash offset, the mask's grey coefficients, Bezier extrema for the bounding box, whitespace, !important and odd polyline coordinates; use cycles, use depth and entity expansion are refused before drawing; every value is checked before the first operator so a refused drawing leaves the page untouched
- page.tcl, xObject.tcl, geometry.tcl, graphics.tcl, pattern.tcl, shading.tcl, pdfObj.tcl, layer.tcl - the CTM is carried per stream and the Figure BBox goes through it; pdfObj written and aboveZero refuse on the value the file carries; a singular placement matrix is refused; -rotate turns about the point -at names through one turnedAbout; an axis without length, page add inside a form and overprint under PDF/A with an ICC CMYK are refused
- image.tcl, imageJpeg.tcl, imagePng.tcl, imagePngAlpha.tcl, imageTiff.tcl, imageTiffStreams.tcl - two pictures with one digest are compared byte for byte; ColorTransform 0 is written for an RGB-coded JPEG by its markers; PNG bit depths are checked against the format's table; every refusal of a picture and its mask is asked before the first object; a truncated JPEG frame, a path beside -data, and an 8-bit TIFF ColorMap are handled
- pdfa.tcl, hyphenate.tcl - the part 4 refusal names what is true and zugferd-2.4 reads the new wording; the module head describes the two-level read
- tests - one or more tests with a mutation proof for every finding, fixtures built in the tests; fourteen tests that held the old behaviour corrected (structure-12.7, 12.9, 15.10, xObject-10.2, field-7.25, zugferd-11.1, 13.5, image-stencil-18.6, svg-2.9, 8.1, text-32.1, import-22.1, importLayer-3.2, update-6.7)
- examples - 05.02 embeds under the name its profile allows, 05.08 pairs its footnote and citation with -ref, 03.04 speaks English, the round 7 leftovers of 01.01, 02.09, 06.02, 09.03 and 11.01, heads of 01.15, 02.06, 02.15, 03.08, 04.03, 08.04 and common.tcl
- Manual, README, skill reference - every changed refusal, option and limit; the error code table regenerated; the skill's check.tcl fails a refusal snippet whose call stops refusing; sixty module versions raised
- Knowingly open: hyphenation keeps its documented two-level rule and the manual now says where libhyphen differs; a mask that fails while its streams are built still leaves the carrier's ICC profile; an unknown command letter in SVG path data is passed over without a report check-in: 438392197a user: alex tags: trunk

13:38
Signature in the structure tree, sign add refuses PDF/UA, ModDate on every attachment, Inf refused as a colour, SVG colour values held finite

- sign.tcl - a visible signature (-rect) is a form field of the document: its widget carries /StructParent, /TU from -tooltip and /Contents from -contents, stands in a Form structure element with an object reference and in the /Fields record like any field, so the three PDF/UA questions read it; an invisible signature stays an artifact, since ISO 14289-2 makes a widget of zero extent one (8.9.2.4.13) and a structure element around it fails the file; sign add refuses a file that claims PDF/UA as TCLPDF SIGN STATE ua before a session is opened, naming the write-time signature as the way
- field.tcl, ua.tcl - the field writer passes the record another module writes; a taken name and the PDF/UA messages name the signature field and the command that describes it
- attach.tcl - /Params carries /ModDate on every attachment, as ISO 32000-2 requires of an associated file (14.13.2, Table 45): the path form takes the file's modification time, -data requires -date (TCLPDF ATTACH ARGUMENT date) rather than a clock that would make two runs write two files; examples 01.04, 06.03 and 10.01 name their dates
- color.tcl - Inf and -Inf are refused wherever a component, a Lab white point or a range is read, through the same predicate that refuses NaN; a white point of Inf used to pass the sign check and fail the write under another module's code
- svgPaint.tcl - a colour component of fill, stroke or an rgba alpha that is not a finite number is refused as TCLPDF SVG COLOUR before the first operator, where it used to die inside min/max or pass as 1.0; a non-finite opacity falls back to the initial value like any other value that is not a number; a stop offset that is no number goes to the shading and is refused there by name
- examples/08.05-signature-accessible.tcl - new: a tagged PDF/UA-1 document with a visible, described signature in the structure tree, and the page says why the invisible one is an artifact
- tests - sign-10.x for both signatures in both orders under both parts, attach-3.6 turned from keeping the missing date to refusing it, eleven attach -data calls in five files name a date, color-parse-1.11 turned from clamping to refusing, svg-finite-41.x, the string guard counts the two widget strings of sign.tcl
- Manual and skill reference - the signature options and the artifact rule, sign state keys, the sign add refusal, -date and its obligation with -data, Inf beside NaN, SVG colour values; error code table regenerated (COLOUR under SVG); six module versions raised
- Knowingly open: stop-color in functional notation (rgb, rgba, hsl) is still refused although SVG 1.1 allows it; an incremental PDF/UA repair in sign add for the package's own files is a roadmap item, not built check-in: 090f6cd151 user: alex tags: trunk

09:25
Reader hardening, COLR radial rings, UA-2 list numbering, NaN colours, update error contract

- importRead.tcl - a number token is held to the grammar of 7.3.3 and anything else is refused as TCLPDF IMPORT SYNTAX with token and offset; an object stream is bounded by its own header before the loop (First inside the stream, N at most what the header can hold, every word a digit string with an offset inside the object part) instead of by whatever the file claims; an unknown cross-reference entry type is the null object of 7.5.8.3 and shadows an older live entry; object and generation numbers written with leading zeros are the numbers they mean, in the reference, at the object head and in the object stream header, through one Decimal helper; a missing path, a directory and an unreadable file are refused at the reader's one entry under TCLPDF IMPORT FILE, so pdf import and the five reading commands answer alike
- importInfo.tcl, import.tcl - the file checks moved into the reader; the Reader wrapper and the copy in pdf import are gone
- update.tcl - a session refuses a missing, directory or unreadable path as TCLPDF UPDATE FILE, and every refusal of the reader underneath reaches the caller under TCLPDF UPDATE with the reader's own class word - at open and at the deferred reads of body and replace - through one Reader helper
- colorFontBand.tcl, colorFontPaint.tcl - a radial band takes the side of an interval from the larger radius of its ends, not from the direction the parameter runs, so a shrinking gradient draws its ring instead of the inverse; a band that lies beyond every corner of the box is told apart from "no clip needed" and skipped, and a gradient whose bands all lie outside answers empty before a shading object is written, so a glyph that draws nothing is refused like any other
- ua.tcl - under part 2 a list whose items carry a Lbl may not say ListNumbering None (ISO 14289-2, 8.2.5.25); part 1 keeps it; the message for a missing -numbering no longer offers None where part 2 refuses it
- pdfObj.tcl, color.tcl - num asks whether a value fits before format sees it, so NaN is refused in the package's words instead of dying inside format; a NaN colour component, Lab white point or range is refused where it is read, in every colour space and at font -color, before it reaches the state; Inf keeps being clamped, in one predicate that turns it into a refusal with one line
- tests - a fixture for object streams and one for padded object numbers, the unreadable-file constraint hoisted into helper.tcl, two tests that carried their target in an exponent rewritten, update-6.2 checks the code and not the message
- Manual and skill reference - number grammar, object stream bounds, null-object semantics, the directory case, the NaN exception to clamping, the part-2 list rule, the UPDATE contract for a whole session; error code table regenerated (FILE under UPDATE); nine module versions raised
- Knowingly open: Inf as a colour component is still clamped and -whitePoint accepts it; the signature widget outside the structure tree (C-01), sign add on a PDF/UA file (C-02) and /ModDate on an associated file (C-07) wait for a decision; content streams are copied byte for byte, so an exponent inside one is not seen check-in: 06f6d1c786 user: alex tags: trunk

06:06
Bitmap colour fonts: sbix faces, AAT morx shaping, and a TrueType collection read by face

- sfnt.tcl - a collection is opened by face (-face, default 0) and rebuilt as a face of its own; the picture tables sbix, CBDT and EBDT stay on disk and are read by offset through openFace, slice and extent, so a 192 MB face costs 0.06 seconds and 28 MB where reading it whole cost 13 seconds and 4.3 GB; a file that is neither a collection nor a bitmap face goes through the old path byte for byte; a table left on disk is refused by sfnt table rather than answered empty
- morx.tcl - new: the AAT extended glyph metamorphosis chain, all five subtable kinds (rearrangement with its sixteen verbs, contextual, ligature, noncontextual, insertion), the six lookup formats and the extended state table, default subtables only, with the work budget of the GSUB machine; a deleted glyph hands its characters to its neighbour after every subtable, so the ToUnicode entry of a ligature keeps their order
- sbix.tcl - new: strikes, glyph records, dupe and flip with a cycle guard, PNG dimensions out of the IHDR, all through sfnt slice
- colorFontBitmap.tcl - new: a Type 3 glyph that places the face's own PNG as an image XObject, the alpha channel as its soft mask, the largest strike unless -strike names one, a flip sharing the source's XObject under a mirrored matrix, a glyph without a picture drawn from its own outline and only an empty outline refused
- colorFont.tcl - -face and -strike; the COLR path and the sbix path share one head; morx shapes the sequences of a face that has no GSUB; a character list the face deletes entirely is refused rather than registered as a family of no glyphs
- font.tcl, type3.tcl - font embed -face; an sbix or CBDT face is refused at embed whether or not some of its glyphs carry outlines, since the keycap bases of Apple Color Emoji are outlines and the other 1397 glyphs are boxes; font info reports bitmaps
- examples/02.18-noto-color-emoji.tcl - one procedure builds the document for either face, and on a machine with Apple Color Emoji the example writes 02.18-apple-color-emoji.pdf beside the Noto one: the same three pages, the paint statistics turned into strike statistics; each half skips itself where its face is absent. pdfimages -list does not see a picture inside a glyph description, so the page counts them itself
- tests - morx.test builds its word list out of the face's own cmap and holds every sequence against hb-shape (3169 of 3196 equal, the 27 others lone tag characters that HarfBuzz blanks after shaping), sbix.test and colorFontBitmap.test on synthetic faces, sfnt.test on collections and the offset reader, notoemoji.test on the count the example has written since the last check-in
- Manual, skill reference, Makefile comment, pkgIndex, configure - the new options, codes and modules; the version of the four touched modules raised
- Knowingly kept: CBDT and OpenType SVG faces are named, not read; morx applies the default features only, since no caller can name an AAT feature; the strike is chosen once per face, not per glyph check-in: 6d35855666 user: alex tags: trunk

2026-08-26
20:58
One equation under each skin-tone ramp of the emoji example

- examples/02.18-noto-color-emoji.tcl - under each of the three ramps a line "base + tone = toned base" out of the face's own glyphs, the modifier on its own drawn as the swatch the face has for it, the builder and the farmer with their third part, so that what the modifier does stands on the page beside the ramp that shows it; the five parts join the colour font's character list check-in: 4edc54d76b user: alex tags: trunk

20:41
Name the origin and the terms of the Tcl 9 logo

- examples/assets/README.md - Tcl9logo.svg is the Tcl/Tk 9.0 logo by Valerie Carroll with Steve Landers, taken unchanged from the published SVG, under the Tcl licence as the wiki page that introduced it says; the placeholder asking the author to confirm the terms is gone check-in: 051f014c92 user: alex tags: trunk

20:28
Put the library names back into the skill and one measurement comment

- doc/claude/TCLPDF.md, SKILL.md - the warning against writing a tclpdf call from memory of jsPDF, ReportLab, FPDF or pdf4tcl names them again, as intended: with the names the warning is sharper than without. The previous check-in had taken them out under the naming rule, and had cut the second half of the sentence in SKILL.md with them; both are restored to their earlier wording
- importInfo.tcl - the comment names jsPDF again as the writer of the measured form check-in: a02c17a111 user: alex tags: trunk

20:21
Norm-review round seven: twenty-nine findings no validator sees, all built

- Graphics - overprint never writes /OP without a word on the fill side, a pattern belongs to the stream that carries it (canvas id), an integer beyond 2^31 is written as a real, a shading angle under -matrix is mapped once, an open arc under a fill in force is refused, save without restore and a q depth past 28 are refused at the stream end, a name past 127 bytes at the call, /Rotate is normalised, an ICC v4 profile binds PDF 1.7, Exif orientation is read into image info and not applied, and the one PDF number bound lives in pdfObj fits behind option number, option point and page distance
- Fonts - an sfnt without glyf and loca is refused at embed, a face whose glyphs are boxes without contours (sbix, CBDT, SVG without COLR) is refused as drawing nothing, shadda and the hamza marks go before the vowels as UTR 53 says, the subset tag comes from the program bytes, Ascent and CapHeight of a Type 1 or bare CFF face come from the glyphs themselves, MVAR is applied, the cmap is chosen in HarfBuzz order, fsType bit 8 turns subsetting off, a positive descender is negated, colour operators are stripped from a d1 glyph, and font info reports masks and fsType
- COLR v1 - sweep angles carry the bias of 1.0 (every sweep stood turned by 180 degrees), srcAtop and xor are built exactly where the masking side is sharp or one level and refused otherwise, a fully transparent gradient is refused as empty, a colour line with all stops on one offset paints below and above, unknown extend and clip formats are refused, and the count of bands, clips, constants and masks per face is kept
- Shaping - a cyclic lookup graph runs against a work budget and returns the run as HarfBuzz does, a nested lookup does not filter the record position by its own flag, GPOS types 1, 2, 3, 7 and 8 are read and applied in the kern path (cursive attachment, pair kerning under every script, chained context shared with GSUB), GSUB type 8 is applied backwards, calt and rclt run in the closing stage, rlig for every script in one stage under latn as measured on HarfBuzz, and kern run answers one place per glyph so a right-to-left line is as wide as textWidth says
- Layout - a standard face in a 2.0 document carries Widths and a FontDescriptor, a refusal position counts code points under 8.6, a horizontally broken table is one Table with one TR per logical row (structureResume), the justify surplus is divided by Th, the word gap is decided per segment face, a tagged right-to-left paragraph measures without the appended space, a number beyond the PDF bound is refused before q and BT, textPath closes its mark on every failure, two-level hyphenation dictionaries are read as libhyphen reads them, column widths must be positive, -fit stops at one point, a cell dictionary needs text, a unit never ends before a zero-advance character, repeated table heads and feet are pagination artifacts, and pagination is linear in the text length
- Structure - structure -ref writes /Ref and UA-2 refuses a TOCI without one, the nesting rules of ISO/TS 32005 table 5 are enforced for inline elements, Art, Document, Caption and NonStruct, structure inside a suspended stream is refused, a Lbl after content is refused, a zoom below zero is refused everywhere (option zoom), bookmark -open and the link options are checked, and structureResume reopens a closed element for children on later pages
- PDF/A and metadata - xmpSchema checks prefix and URI, a name tree uses one encoding for all its keys, sign -field refuses a name a field already holds, encrypt -metadata 0 writes the Identity crypt filter, a date is respelled for the version the file is written in, zugferd refuses a foreign encoding declaration, attach -name refuses control characters, an XMP packet handed in must carry the claimed pdfaid or pdfuaid description, sign add refuses a DocMDP P 1 document, -unit -format -orientation are checked at the call, and a missing directory is refused with its own code
- Annotations, forms, import - the import checks every object of a closure before the first reservation, a field value outside the field font is refused at the call, values round-trip with a line feed, up to 1024 bytes after EOF are tolerated, a second import of the same file shares its streams, only MCID marks are stripped from a foreign stream in a tagged document, pdf info leaves content keys empty for an encrypted file and reports a certification, and each geometry annotation takes only its own options
- Tests - one test per fix with a mutation that turns it red, a shared freshInterp helper for the three field tests that ran a script in a fresh interpreter, seven tests that held the old behaviour corrected, and a test that pinned a module version made version-free
- Manual, README, skill, examples - every sentence the review found wrong or missing, the generated error code table, the figures, new snippets for the calls that had none, twenty-three example heads and five printed page texts, and the names of other PDF libraries taken out of what ships
- Knowingly kept: the empty ToUnicode target for a glyph without a character, since both alternatives fail PDF/A-3u; /MK /R on a rotated page, since it governs a redrawn appearance only; the cluster order of a Nastaliq dot, whose ink lands where HarfBuzz puts it; and the width of hyphenate load for a two-level dictionary check-in: 87727ccab0 user: alex tags: trunk

14:01
Source In as a clip path, and the winding that decides it

- colorFontRegion.tcl - new: the arithmetic behind a clip standing in for a mask - outlines flattened, the winding number asked at the faces of an outline's own arrangement rather than at its vertices, a contour turned to run the other way, and one shape tested for lying inside a union of others
- colorFontPaint.tcl - a Source In whose backdrop is a stack of opaque outlines with a translucent shape laid over it is drawn as a clip on the opaque union where the shape lies inside that union, decided per glyph at run time and never from bounding boxes. Several outlines become one nonzero path only after every contour has been turned to the same winding, since concatenating them as they stand is not their union; an outline that winds both ways keeps the mask, as does a shape that sticks out. Two readers draw a box behind a flag when the same is done with an alpha mask inside a Type 3 glyph; a clip is read the same way by all of them
- glyfPath.tcl - the four lines that turn contours into path operators stand on their own, since a caller that reverses a contour needs them too
- tests/colorFontRegion.test - new: winding, reversal, containment and the self-crossing contour. tests/colorFontPaint.test, tests/glyfPath.test - the clip against the mask, a stack that still masks, a stack with two shapes. Every test with a mutation that turns it red
- examples/08.04-zugferd-signed.tcl - the auto_path line every other example carries, so the script runs from the source tree without TCLLIBPATH
- Knowingly kept: the masks on outlines that wind both ways and on shapes that stick out of their union, since a clip there would be wrong in every reader rather than in two check-in: a4d6335a56 user: alex tags: trunk

12:27
Soft masks out of Type 3 glyphs where a plainer construction exists

- colorFontBand.tcl - new: a gradient with varying stop alphas is drawn as nested bands of constant alpha instead of a luminosity soft mask - level sets, each painting the same shading over a narrower clip with the alpha increment as ca, so that a band edge is an increment over painted ground and not a seam. Strips across a linear axis, even-odd rings for a nested radial, the wedges of the sweep. Two readers anchor the matrix of a soft mask set inside a Type 3 glyph stream to the page rather than the glyph and lose the masked shape; a clip and a constant alpha are misplaced by no reader. The technote of 2026-08-26 records the finding
- colorFontPaint.tcl - a Source In composition takes a constant alpha where its backdrop is one solid shape and a clip path where it is a plain opaque outline; the mask remains for a translucent shape over an opaque stack, for a radial cone whose circles do not nest, and for a colour line that would need more regions than the step allows
- tests/colorFontBand.test - new: the band arithmetic, the three geometries and the step; tests/colorFontPaint.test - the wiring, the shortcuts and the fallbacks. Every test with a mutation that turns it red
- Knowingly kept: the alpha masks on the flags, and the size the bands cost, since a shading painted once per band is larger than one shading under a mask check-in: 40b9899a3b user: alex tags: trunk

10:07
Feature wiring behind the context machine, and emoji sequences

- forms.tcl - the closing stage runs in two hb-order stages, rlig first and then liga with clig under the resolved script, proved with a patched face whose lookup numbering would have caught a shared stage. The DejaVu lam-alef gap is closed; Arabic still matches hb-shape word for word, and -ligatures 0 keeps rlig, since shaping is not typography
- liga.tcl - clig is read beside liga, both on and off together, and a contextual ligature reaches its plain lookup through the chain. Every Latin face with either feature now matches hb-shape over the full word list
- type3.tcl, colorFont.tcl - a glyph may stand for several code points: colorFont applies the face's own ccmp to the text, a joined sequence becomes one glyph with one advance and its whole sequence in ToUnicode, selectors ride on their neighbour, a splitting substitution and the 256th glyph are refused by name, and the code grant survives a glyph script that defines glyphs of its own
- text.tcl, textBlock.tcl - a fallback chain offers a longer-than-one unit only to a face that registered exactly that sequence, so the chain order holds and the cost of a colour face in the chain drops fourfold; the emergency break cuts at unit boundaries, which also ends half-surrogate refusals under Tcl 8.6
- The review round on this build found and fixed eight faults: the chain order loss, the torn sequences, the byte count of a glyph name, a soft hyphen that reached a face, a stage claim the trace disproved, a stale code grant, a manual contradiction and one wrong figure
- examples/02.18-noto-color-emoji.tcl - new, three pages from the real face: the emoji row of 02.09 in colour, a double-size row, sequence units, and two skin-tone ramps of the same icon across all five modifiers. The 25 MB face lives in the tree unversioned and outside the source archive, like the Mustang jar; the example skips itself where the file is absent and says where to get it
- examples/02.09-writing-systems.tcl, examples/02.14-colour-font.tcl - the ligature switch shown on the page, a sequence block over the self-built face, and a label that stands over its own words
- tools/archive.sh - the emoji face is excluded from the source archive, with the reason beside the Mustang line
- doc/tclpdf.md - sequences under colorFont, the ligature paragraph tells the new truth, the mark-order decision carries its measurement, and the two computed INITIALVIEW classes are named under the generated table
- Knowingly kept: harakat stay in input order as decided in round five, now with the measured consequence at the code; two spellings of one emoji cost two register places, since each code carries exactly one ToUnicode entry check-in: 7b0cea6f15 user: alex tags: trunk

05:25
Contextual substitution and COLR version 1

- gsubContext.tcl - new: contextual and chaining substitution, GSUB types 5 and 6 in all six formats plus the extension wrapper, read and matched but never applied here. gsubApply.tcl rebuilt onto one application walk whose nested lookups run through the same machine, with the HarfBuzz shift arithmetic for records that grow or shrink the run. With this the last Arabic refusal falls: rlig over chaining lookups is applied, and the shaped output of every Arabic face in the tree now matches hb-shape exactly, Nastaliq included
- Types 3 and 8 stay out - no face in the tree carries them in a feature this package applies, and the module says so by name
- colrPaint.tcl, colorFontPaint.tcl - new: COLR version 1. The reader turns all thirty-two paint formats into a tree of eight node kinds; the drawer writes that tree as a Type 3 glyph stream - gradients as shadings, the sweep as a fan of Gouraud triangles with two rim vertices at every hard stop, per-stop alpha as a luminance soft mask in glyph space, compositing over blend modes in isolated groups and alpha masks built from form XObjects. colorFont takes a version 1 face, a version 0 face, and a glyph with no colour entry through its plain outline; the empty glyph is still refused
- The review round on this build found and fixed four faults no validator saw: a soft mask inside a composition erased the outer mask, extend repeat flattened to pad after its first period, a hard sweep stop blurred across one wedge, and the nesting cap claimed a HarfBuzz limit that is actually sixty-four
- colr.tcl, colorFont.tcl, type3.tcl, geometry.tcl, liga.tcl, forms.tcl - version 1 acceptance, the three-way glyph switch, resource pairs for streams that carry their own XObjects, matrix inversion, and comments that no longer give type 5 to 8 as the reason clig is off
- tests/helper.tcl - builders for whole GSUB tables, since a context lookup names other lookups by index
- examples/02.17-colour-font-v1.tcl - new: the paint kinds one badge each, drawn from a self-built face. examples/02.09-writing-systems.tcl - lam-alef and the lookups that reach it, with the one remaining difference shown on purpose
- doc/tclpdf.md - colorFont rewritten for version 1, the two deliberate departures from normative wording named, the Arabic section no longer lists a chaining rest
- Knowingly open: liga under the arab script wants a script API, clig stays off as a feature decision, composite outlines and the Plus mode and a palette sentinel inside a gradient stop are refused by name, and COLR variations draw the default instance check-in: 1ffbe3ab12 user: alex tags: trunk

2026-08-25
23:00
A public arc command, and a Tk canvas drawn as vectors

- shape.tcl, geometry.tcl, svgPath.tcl, document.tcl - doc arc with -start, -extent and the styles arc, pieslice and chord, angles counter-clockwise from three o'clock as the page shows them. The Bezier approximation moves out of svgPath into geometry as arcSegments and both callers share it; svgPath writes the same bytes as before. Modules to 1.7, 1.4, 1.2 and 1.14
- -style arc refuses -fill; chord is the word for the shape a fill would produce
- examples/11.01-tk-canvas.tcl, tests/tkcanvas.test - new: a canvas read through type, coords and itemconfigure and drawn as vectors, in a new group for binding other Tcl packages. Both skip themselves where Tk is absent. It is an example and claims no completeness - bitmap and window are passed over by name, stipples, arrows, -smooth and font mapping are not built
- tools/mkerrorcodes.tcl - new: the manual's error code table is generated by a tool in the tree instead of throwaway code, and it reads all three spellings of -errorcode. tools/check.sh step 11 fails when manual and source disagree and names the command that repairs it
- tests/errorcode.test - errorcode-1.3 reads all three spellings, errorcode-1.4 asks the same of a fixture carrying a bad code in each
- examples/01.01-shapes.tcl - a third page for arc: the three styles, the angle scale, and the refusal it can reach
- doc/tclpdf.md, doc/claude - the arc entry, the angle convention, the regenerated table, and arc in the skill reference that make check runs
- Knowingly left: INITIALVIEW builds its class from the option name, so no generated table can name it; the tool warns on every run with file and line
- Knowingly left: a computed class that is the last word of a topic without other classes stays silent, since it cannot be told from a topic that carries its facts after its name
- Knowingly left: the Tk example's test makes no claim about that run's console output check-in: cc048333e7 user: alex tags: trunk

20:24
Every refusal carries an error code, and two examples at the front

- forty-eight modules - the five hundred and eleven refusals that carried no -errorcode have one. With them, every refusal this package makes carries one. Fifty-four topics; where a topic has classes the third word is one, and it says what the caller has to do about it: ARGUMENT a wrong value, STATE a wrong order, NAME or ALIAS something that does not exist, FOREIGN a file this package did not write, DAMAGED a broken one, ROOM too little reserved space
- tests/errorcode.test - new: the property held over the whole tree rather than per module. No refusal without a code, no code whose first word is neither TCLPDF nor Tcl's own, and a counter-check that the guard finds one when there is one. These five hundred accumulated one module at a time and nothing in the suite noticed
- doc/tclpdf.md - the sentence "Only the codes documented here are contracts" was untrue after this and is replaced. The table of every topic and every class is generated from the source, not kept by hand
- tclpdf.tcl - an unknown subcommand of tclpdf itself answers with Tcl's own TCL LOOKUP COMMAND, in Tcl's own wording, so a mistyped command behaves as a mistyped command does everywhere else
- examples/00.02-hello-world-svg.tcl - new: the smallest program that draws a picture. Nine lines, no common.tcl and no footer, and one call more than 00.01. The logo reaches the file as path operators, so pdfimages lists no image at all
- examples/00.03-error-codes.tcl - new: eight refusals from eight topics with the code each one answers, and the same refusal put through three handlers of different width. The message is deliberately not on the page - it is the half that may be reworded, and reading it is the habit the codes replace
- examples/01.16-prepress-control.tcl - the control strip is laid out over two pages by what reads it: flat patches for a densitometer, then the figures a loupe needs. Ramps run across the sheet, the registration marks are four pairs of target and four-square mark, and the head carries a process mark at each end instead of a tinted bar. Yellow takes a black numeral, since white on yellow is not there on paper
- tests/helper.tcl, tests/version.test - eachModule: walking the tree and reading each module's source stood twice and was about to stand a third time check-in: 940d2568a9 user: alex tags: trunk

17:48
Overprint, and the three examples that came out of it

- graphics.tcl, shape.tcl - overprint as a graphics state: doc overprint -fill -stroke -mode writes OP, op and OPM, and every shape takes -overprint for both sides inside its own q and Q. The version asked for is the one the call writes, a call naming none of the three is refused, and the shapes keep their own bracket so an overprint cannot leak into the rest of the page. Modules to 1.6 and 1.5
- doc/tclpdf.md - the overprint entry, the error code TCLPDF GRAPHICS OVERPRINT under contract, and what the switch is worth: black text on a cyan panel keeps its plate underneath, and a light colour overprinted is the mistake a proof exists to catch
- tests/graphics.test - six tests over the three keys, the refusals, the version floor and the bracket. Five mutations tried, all caught
- examples/01.16-prepress-control.tcl - new: a press control strip on two pages. Tone scales and colour bars per plate, ramps as shadings, a slur and doubling gauge, four kinds of registration mark, screens as tiling patterns, screened ramps drawn dot by dot since a tile cannot grow its dot, rosettes, and the two overprint rows that look alike on screen. No image in the file at all
- examples/01.02-colour.tcl - a sixth page: why there are two colour models. Three circles each, Screen on black for light and Multiply on paper for ink, and the fourth plate beside the three inks that stand for it. It says outright that the two black patches look alike on screen, since a reader has no inks
- examples/01.15-text-fit.tcl - new: one line into a given box. The same string in four rectangles, what -spacing does to the arithmetic when it adds an amount that does not shrink with the size, the two refusals a standard face can reach, the one case that is fitted rather than refused, and the four anchors
- examples/01.06-stamp.tcl - the fitting page moves out and the file is a stamp again. Its footer moves to the A5 page, since the last page is an 88 by 55 label turned by Rotate 90
- tests/text.test - text-fit-31.15, the counterpart to 31.13: a box small enough to look wrong is still fitted, and the size written is not nought
- examples/03.06-image-icc.tcl, examples/08.02-signature-visible.tcl - who Erika Mustermann is, in English, in the source and on the page. Where the sources disagree over whether the photograph is of a real person, the comment says so and the page keeps to what is not in dispute. The signature block is a procedure now, called by both documents that script writes
check-in: 502fc448a3 user: alex tags: trunk

14:21
Norm review round 6, and the work it turned up

- annot.tcl, field.tcl, import.tcl, font.tcl, writer.tcl, update.tcl - refusals that stood after an object number was reserved now stand before it, and what cannot be moved gives the number back through the new writer and update release, so an error the caller catches leaves the document writable
- structure.tcl, structureWrite.tcl, structureDest.tcl, structureReport.tcl - thirty-five refusals in seven classes: what the caller has to do about it decides the class, and the third word means the same thing throughout one
- afm.tcl, colorFont.tcl, writer.tcl - six more refusals under contract, and a version floor asked of the writer itself now carries the code every other version refusal has
- option.tcl, page.tcl, graphics.tcl, image.tcl, xObject.tcl - NaN and Inf are turned away where a measurement is read rather than where the arithmetic trips over them; the tests that read the old wording keep it, since only values that are doubles at all are judged here
- xObject.tcl - align and valign anchor a form without -fit, the way they anchor a picture
- tableDraw.tcl, xObject.tcl, structure.tcl - a cell that raises while it draws closes its artifact bracket, a form inside a form puts the suspend flag back, an empty -tag is refused, and the automatic id of a Note steps past one the caller took
- link.tcl, ua.tcl - the link checks read the annotations this module recorded instead of grepping the serialised object body, and Figure and Formula are held to -alt or -actualText wherever they are opened
- text.tcl, textBlock.tcl, leader.tcl - fit measures with the options it draws with and solves for the size where spacing adds a flat amount, align measures the fitted line, ttb refuses fit, a leader whose fill does not lengthen is refused, and balance divides evenly where the line count divides
- xmp.tcl, pdfa.tcl, zugferd.tcl - a control character or an unpaired surrogate is refused, the prefix register is keyed on name and namespace together, conformance A is checked in both orders, a date without a zone keeps the day and drops the time, and a level already claimed survives zugferd
- image.tcl, shading.tcl, shape.tcl, geometry.tcl - an inline image binds the file version both ways, a pattern colour space is refused for a shading, singularity is judged over the numbers actually written, and rect and clip check -at and -size
- color.tcl - the tint transform of a DeviceN colour reached past the tints from the third contributing colourant on, and that plate painted nothing at all
- svgClip.tcl - new module: clip-path as a clipping path with the union of its shapes, mask as a luminosity soft mask; clip-rule and the style a referenced subtree starts from are inherited from its ancestors
- xml.tcl - a node answers for its parent, under both parsers
- svg.tcl, svgElement.tcl, svgPaint.tcl - preserveAspectRatio with all ten alignments, meet, slice and none, reaching the fitting before the box is measured; font-weight; a gradient on text; rect and circle follow the geometry SVG 9.2 and 9.3 lay down; a covered drawing reports the box it was cut back to, as a picture does
- sfnt.tcl, subset.tcl, type1.tcl - a table reaching past the end of the file is named instead of raising a bare Tcl error, a glyph name outside Annex D gets its Differences array, a face without vertical metrics gets no vertical resource, and VORG travels without vhea
- tests/helper.tcl - the guard that counts refusals without a code read one line at a time and called every wrapped one bare; the both-parsers helper moved here, a second file wanting it
- examples - nine defects only a rendered page shows: a footer under the anchor row, captions inside the drawing they name, a total that added a negative row, an ellipse drawn round the corner of its own box, and a paperclip that read as the box a reader draws for a missing glyph
- doc/tclpdf.md - every new refusal described, nineteen error codes into the contract, and four sentences that the work made untrue check-in: 0f9e48cd6d user: alex tags: trunk