A document at the root of a checkout of 68377 folders needed 56 minutes, because the converter named the suite, the document folder and the build folder with `//` in TEXINPUTS; it now names them without recursion and the same document converts in 11.5 seconds. A file below the document no longer replaces a package of TeX Live. The security review of the pending changes found four defects, each fixed with a test proven red against the old files and green against the new ones twice: an HTML table read in an empty sandbox, so an iframe opens no address; form labels written through the LaTeX writer, so they are set as text; the form pattern scans a line once instead of quadratically; a kept build folder no longer lays the links of an earlier drawing over a new one. The form tests remove the PDF of an earlier run before each conversion. Also carried: forms out of Markdown, link colours from the company, clickable links in prose, HTML tables and SVG drawings, the watermark, and the further changes of 1.0.1 and 1.0.2 in the CHANGELOG. npm test: 1232 of 1232 checks. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
216 lines
34 KiB
Markdown
216 lines
34 KiB
Markdown
# Tests
|
|
|
|
The five measurements, where each one looks and what it is worth. `npm test` runs all of them and counted 1232 checks on 2026-11-14.
|
|
|
|
## origin
|
|
|
|
`tests/origin.py`, 7 checks, against `pacta.sty` as `kpsewhich` finds it.
|
|
|
|
The suite came out of that file, and the proportions of its logo were decided there and confirmed for every company of the family: the logo of the page head at 2em, the name beside the logo at 0.8 of the height it is asked for, the gap beside it and the gap over the address line at 0.1. This test holds all four as values of the family against the defaults of the suite, and compares the height with `pacta.sty` as long as that file carries one of its own. Since 2026-10-05 it is a configuration of this suite and carries none, which the test reports. The title block of the suite carries no logo, so the height the origin gave its title logo has nothing to be compared with.
|
|
|
|
A derivation may replace such a number only where it reproduces it. Four of them stood here as derivations for half a day, and every one came out at another size than in the two companies beside this one: the name was fitted to the ink of the drawing, and a drawing that fills its whole box got a name half as large again as the family sets it. Where Pacta is not installed, the test says so and passes — a missing neighbour is no statement about this suite.
|
|
|
|
## identity
|
|
|
|
`tests/identity.py`, 178 checks. Two kinds of question: what the suite may not contain is a property of its source, what a company really reaches is a property of the page.
|
|
|
|
The first kind is asked the way round that holds: not whether the templates carry the right colours and faces, but whether they carry any at all. A copy passes every check that asks whether the values are right, and is wrong on the day the one place changes.
|
|
|
|
| Measured | Why |
|
|
| --- | --- |
|
|
| No `\definecolor` with a value in any of the four suite files | a colour here is one company's property in a file every other company loads |
|
|
| No colour and no face set in the three templates | one definition of everything in one place, included everywhere |
|
|
| A document that opens with `\DocumentMetadata` builds without a word about `hyperxmp`, and its title still reaches its properties | the kernel writes the XMP stream itself there and turns a second writer away with a warning; a warning is an error in the projects that build for PDF/UA, so the template must not ask for one |
|
|
| A document that declares its language carries it in its XMP | the template sets it nowhere, because hyperref takes it from babel; that this really happens is measured |
|
|
| Nothing stands after `\endinput` in any of them | LaTeX stops reading there, and a block moved to the end of a file lands behind it without a word in any log |
|
|
| Every role a template reads is declared | a role that is not declared fails the build of a company that does not set it |
|
|
| Every option of a template stores a value that a line of the template reads | an option that only stores takes what a company writes, raises no error and changes nothing; the title logo height was such an option from the day the logo left the title block |
|
|
| The head ends on the right edge of the text | the logo stands where the text ends and not in the margin |
|
|
| The page number stands at the right edge of the foot | |
|
|
| The title and the author stand in the XMP stream | that is where a file search and an archive look, and `hyperxmp` writes the author there and nowhere else |
|
|
| No face LaTeX fell back to | a font without a shape in the encoding in force is replaced by Computer Modern, and nothing but the log mentions it |
|
|
| The symbol family is embedded | the marks come from it, because no text face carries them |
|
|
| A company whose logo is a FILE gets it on the page, and at twice the height it comes out twice as high | the second of the two ways a logo arrives, and the case that catches a computation which reads the number of a length and drops its unit |
|
|
| A link stands in the colour the company gives the role and carries the line under it; a document that sets nothing carries neither (`link_style`, F1.9) | a PDF and the website of one company are read as one design, so the colour comes from the palette and the line from a setting, both out of that company's stylesheet; the colour is asked of xcolor in the same build, because a value written into the test would be the palette of one company |
|
|
| A contents page carries no line under its entries, while the link in the text does (`link_style`, F1.9) | every entry of a table of contents is an internal link and takes the colour of the role, so a line under each of them would draw a grid over the page; the line belongs to `\href` and `\hyperref`, the two commands a text writes, and `\contentsline` uses neither |
|
|
| A link inside a section title builds and keeps its destination (`heading_link`, F1.9) | a title is written out three times over, into the contents file, the running head and the bookmark, and a replacement of `\hyperref` that is not robust is expanded there while its argument is still unread; one document of nineteen in the PLIM set carried such a title and stopped building |
|
|
| A section carries a destination under the name of its label (F8.3) | a link from another document into a section carries that name; the option that names the destinations was passed after the identity had loaded hyperref and reached no company |
|
|
| Every pixel of a page of furniture lies on a line between two declared colours and white | the roles are read off the identity, their values asked of xcolor in a probe, and the rendered page measured against them, so ink nobody declared is red whatever the company; proved with an undeclared orange, 104 colours off the palette |
|
|
| A company that sets `icon` drops the drawing the identity it loads had set | a daughter company takes the design of its parent and its own mark; the drawing stayed and the file reached nothing, which the shape of the mark on the page shows and the source does not |
|
|
|
|
### The lockup of two lines
|
|
|
|
A company that sets a sentence under its name reaches the head with it. The measurement takes the words out of the text layer and not the ink out of the raster: the logo stands beside both lines and is one shape as tall as the two, so in the picture it bridges them into a single band and no threshold separates them again. The head of the first page carries the name, the tagline and the address, the head of every other the first two, because the address belongs on the sheet that leaves the company. The two lines share their left edge and the second is the smaller. A logo in a SENTENCE carries no tagline, because the place asks for it and the company only says what it is. And the page keeps the room for the taller block: the head is measured again when the identity arrives, and without that it was measured on a company that was still empty and fancyhdr asked for 16.8 points on every page.
|
|
|
|
### The two measured sizes
|
|
|
|
The lockup stands alone on a page, so nothing but it carries ink. The words come out of the text layer with the boxes they stand in: the tagline is as wide as the name over it to within a point, and the two share their left edge. The icon is measured at the ink of the drawing, which fills its own box, against the extent of the text beside it. Then the three overrides, each on its own build: a factor takes the tagline off the width of the name, a height of three centimetres and a width of one reach the icon to within a point and a half, and the icon asked for at a height comes out as wide as it is high, because the mark of this company is a disc and its proportions are kept.
|
|
|
|
### The tagline colour
|
|
|
|
A company that names no colour for its tagline sets none, so the line stands in the colour of the name over it; a company that names one reaches that line alone and the name keeps the colour of the lockup. The same document is built twice, with the key and without it, and the measurement takes the DARKEST pixel inside the box each word stands in: the mean over a word measures how much white stands between its letters, which is a property of the size and not of the colour. The quiet role of the example company is a 55 percent tint of its brand colour, so the two lines come out far apart where it is named and together where it is not.
|
|
|
|
### The body colour
|
|
|
|
The body text stands in the text role of the company. LaTeX writes in its own pure black until it is told otherwise, and a brand whose dark is not that black then carries a colour nobody chose on every page. The same paragraph is built twice, once with the text role set to a grey of 55 percent and once with the black the example company sets, and the darkest pixel of two words is read: the grey reaches the page, and the black is the control that proves the measurement sees the colour of the type at all.
|
|
|
|
### The rule colour
|
|
|
|
The rules of a table stand in the text role as well. colortbl draws in its own pure black, and the row rule used to reset every following rule to exactly that black. A table of three rules and one row rule is built twice, with the text role at a grey of 55 percent and at black, and the darkest pixel of every pixel row that is dark over a long unbroken run is read: only a rule is, because a line of type has white between its letters. The grey reaches the rules, and the black is the control.
|
|
|
|
### Address line and logo
|
|
|
|
Five addresses, from a bare domain to a sentence, each at 1cm, 2cm and 4cm, one lockup to a page. On every page the address line begins where the ink of the icon begins and ends where the box of the name ends, to within a point and a half; the edge of the icon is read in the rows above the address line, because the ink of the whole page begins with the address wherever the address reaches past the icon. That is how a word space in front of every icon was found, 2.4 points at every size. And at twice the height the block is twice as high, the logo twice as wide and the address line twice as wide, to within three percent: a size that reads the number of a length and drops its unit passes at one height and fails at the next. With the size of the line fixed at ten points instead of derived, all fifteen pages and most of the ratios turn red.
|
|
|
|
### The ground of a slide
|
|
|
|
A deck of the example company is built twice, once as it is and once with `canvas-top`, `canvas-bottom`, `sidebar-top` and `sidebar-bottom` named in its own preamble, after the theme, and the second slide is rendered in colour. Without the roles the ground is white at the top and at the bottom. With them the top of the ground is mostly the red named for it and the bottom mostly the blue, the sidebar green at the top and yellow at the bottom. With Beamer's own shading in place of the hundred bands the ground of the second slide comes out white, because xdvipdfmx writes the shading into the first page alone; and with the roles chosen when the theme is loaded instead of when the slide is drawn, a deck that names them in its preamble got the fallbacks.
|
|
|
|
### The marks fill their box
|
|
|
|
`\success` and `\fail` at sixty points, one to a page, and the share of white inside the box each of them paints: 0.12 for the check and 0.21 for the cross with DejaVu Sans, inside a window of 0.08 to 0.30. A sign the symbol face does not carry leaves the box without white, and a box that lost its colour is nearly all white; with the sign taken out, both marks measure 0.00.
|
|
|
|
### The SVG logo
|
|
|
|
A company whose logo is an SVG alone is built in a directory of its own. `bin/logo.py --check` fails on it, the LaTeX build stops with «exists as an SVG only» in the log instead of «File not found», `bin/logo.py` writes the PDF beside the SVG, `--check` passes after it, and the next build carries the logo on the page.
|
|
|
|
### The rendered page
|
|
|
|
Every measurement on pixels renders one page into one file under one name and removes it first. pdftoppm names a page after the number of digits of the last page of the document, and the name was guessed in the order `page-1`, then `page-01`: page 1 of a document of ten pages and more was read from the `page-1` an earlier test had left behind.
|
|
|
|
## layout
|
|
|
|
`tests/layout.py`, 218 checks, on the rendered page and in the aux file the page writes.
|
|
|
|
### The line of the head
|
|
|
|
The heading in the head and the name beside the logo stand on one text line. The two are nine points and sixteen, so every other alignment shows: hung from their top edges they fall apart by the difference of their cap heights, measured at 7.9 points, and the head reads as two blocks that missed each other. The measurement takes the lower edge of the first capital on each side, both flat on the baseline; aligned, the two end a third of a point apart at 300 dpi, which is the rasterizer and not the layout. It runs over both shapes of the lockup, the one of one line and the one of two, because a block that has grown a second line still has to hand the head the baseline of its first.
|
|
|
|
### A heading after a list
|
|
|
|
Three headings, each followed by a list, and a table under the last. Measured in the aux file, where every reservation stands under the number of the announcement it belongs to, and on the page: the table reserves its own room, a few lines, and the first heading stays on the page it begins. A heading used to take over the number of the one above it whenever anything had announced before, and a list sets an `\everypar` of its own, so the forgetting that the first paragraph does never ran. Proved by asking before the fix: 228 points under the number of the first heading, where the table needs a few lines.
|
|
|
|
### The word across the page
|
|
|
|
The same page twice, once with the option and once without: the page with the word carries more than twenty times the tinted pixels of the page without it, the word spans more than four hundred points in both directions, and it touches no edge of the sheet. The threshold of a layout test sees type and would report this page as empty of ink, so the measurement reads every pixel that is not the white of the paper. The size follows the sheet and the word: `DRAFT` and `CONFIDENTIAL` are of very different length, and a size in centimetres that fits the first pushes the second over the edge.
|
|
|
|
### The caption under a picture
|
|
|
|
The caption stands centred under the picture it belongs to, over one line and over several. Measured on the rendered page: the picture is the tallest band of ink, its caption is what follows within a line of it, and the middle of each caption line lies within three points of the middle of the picture. Proved by setting the caption back to the left edge: the short one stood 239.3 points beside the middle of its picture, the second line of the long one 46.3.
|
|
|
|
### The division of the head
|
|
|
|
A company with a long name, a long address and a logo of four ems gets a head that stays on the paper. The line used to be divided by fixed shares, 0.45 of it for the logo and 0.55 for the running head, and a share fits the one company it was read off: this block needs 0.57 and stood 65.11 points past the right edge, with the annotation of its link outside the page box. Measured on the rendered page: no box over the edge in the log, the ink of the head inside the text block, and the running head still there beside it. The logo now takes the width its block measures and the running head the rest; a block that would take more than three quarters of the line is set at the height at which it fits, which keeps its proportions.
|
|
|
|
### The opening of a document
|
|
|
|
The distance under the title block is the same whether the document opens with a heading or with a paragraph. A heading brings three lines of space with it and the title block does too; where the two stood one under the other, the page carried six lines of white against the three it gives everywhere else, measured at 76.8 points against 44.2.
|
|
|
|
### Heading under heading
|
|
|
|
A heading directly under a heading stays with it, over every distance to the foot of the page and in three forms: with text under the second heading, with a table, and with a picture. The second heading used to reserve its own eight lines, and that reservation broke the page between the two — measured at three of sixteen distances, where the upper heading stood alone on a page with nothing under it.
|
|
|
|
### The size of a picture
|
|
|
|
Three pictures, each alone on its page, measured at the ink: an upright one at half the text height, a lying one at the full width of the line, a raster one at the width its own size allows. Every one of them centred to the point. A fourth document gives a raster picture a tenth of enlargement by option and measures that it stays there, and a fifth puts a picture where a third of the page is left and measures that it is made small enough to stand on it.
|
|
|
|
### The title rule
|
|
|
|
Measured between three blocks of ink on a page that carries nothing else: a paragraph, the heading, a paragraph. Over the heading stands one line and a half, under it half a line — the numbers of the family, and the three to one the rule asks for. Both are measured against the line of the body text with the slack of the two faces that meet at them, and three lines over a heading, which the same source carries in its current state, falls out of that range.
|
|
|
|
### The left edge
|
|
|
|
The blocks of ink that begin further right than the text are only the ones the layout puts there.
|
|
|
|
### Announcement and table
|
|
|
|
An announcement and what it announces stand on the same page, over 32 cases: a heading with a table under it and an announcing sentence with a table under it, each pushed down the page line by line over sixteen distances to the foot. The fixture produces the situation itself; a document that happens to carry it proves nothing about the fifteen distances it does not carry.
|
|
|
|
This is the measurement the family has paid for three times, and it found a defect of its own on the first run: the template measures what a table needs in longtable's own terms and never loaded `longtable`, so the first announcement that a heading carried ended the run with "Undefined control sequence".
|
|
|
|
### The room for the head
|
|
|
|
The head reserves what it measures at itself, and only a document that asks for a mark the family did not set can prove it: at the one height every example carries, a reservation computed from a factor and one taken from the box look exactly alike. The same document is built with the mark of the family and with twice it. The page reports the numbers it was laid out from, so the upper edge of the text block follows from them, and the ink of the rendered page is measured against that edge: nothing of the head reaches below it, nothing of the text above it, the reserved room grows with the mark and the text begins that much lower. Proven red against the defect it exists for, a mark of four ems beside a head height fixed at the 31.17 points of the family: fancyhdr writes its complaint into the log, the room stays where it was and the text does not move. Reported on 2026-09-22 from a sibling template of this family, which found the same gap in its own suite.
|
|
|
|
### The two distances
|
|
|
|
One line of the body text between the lower edge of the head and the upper edge of the text, and the same line between the lower edge of the text and the upper edge of the foot. The page is laid out from three lengths, so the three are what the fixture asks the run for: the distance over the text, what the page reserves under it against what the foot really measures, and where the first line of a page begins in the text block. It is built twice, once with the bare line in the foot and once with a picture of two centimetres in it, because what stands in the foot changes the room it needs and not the distance. The rendered page carries the same measurement at the ink: between the last line of the text and what stands in the foot there is a line, and never two.
|
|
|
|
### The two lowest levels
|
|
|
|
The fourth and the fifth heading level run into the paragraph they open, and they are announcements all the same: each is pushed down the page line by line over sixteen distances to the foot, with a table under it that asks for far more room than a heading does by itself. Until 2026-09-22 only the first and the second level were ever built by a test, so the claim that the reservation reaches the other three rested on reading the code.
|
|
|
|
### The foot
|
|
|
|
Whatever a document puts into the inner corner of the foot stays in the foot: a picture of two centimetres does not overprint the text above it, it ends inside the margin the page keeps, and it really arrives. The room for it is reserved where the document sets it, in the preamble; from `\begin{document}` on, geometry sets the bare length and recomputes nothing, and the picture then stood on the lower edge of the sheet — measured at 150 dpi, where its grey ran through to the last pixel row of the page.
|
|
|
|
## md2pdf
|
|
|
|
`tests/md2pdf.py`, 84 checks, on the PDF the converter produces from `examples/report.md`, from an HTML table whose cell names a page on a local server, from a drawing that loses its links between two kept builds, from a document with a package named like one of TeX Live two folders below it, from a document of three formulas, from one of two pictures, from a page a picture leaves early, from a document with links in prose, an HTML table and an SVG drawing, from the same document written twice, once in Markdown and once in LaTeX, from three documents that try to run code or to overwrite a drawing, from a company whose identity lies outside the TeX tree, from a caller whose search path carries a file named like the probe, and from a title with two sections over two pages.
|
|
|
|
| Measured | Why |
|
|
| --- | --- |
|
|
| The converter carries its execute bit | the README describes a link to it on the PATH, and a file without the bit ends in "Permission denied" |
|
|
| The converter produces a PDF at all | |
|
|
| The probe wrote a measurement, and the line it measured is the type area of an A4 page with these margins | without the probe the column widths of every company are computed with the numbers of the company this suite came from |
|
|
| No ink outside the margins on either side | a Markdown table says nothing about its column widths, and without the filter the last words stand past the edge of the paper |
|
|
| The title block, the table and the path in the running text arrive | |
|
|
| The symbol family is embedded | |
|
|
| A document that does not exist ends in a message that names it, and in no PDF | |
|
|
| A formula arrives as a formula, in a sentence, on a line of its own and written over several lines, and the page carries a mathematics face | a line that carries nothing but `=` is the underline of a heading in Markdown, so a formula over several lines used to come out as a heading of the first level while the build stayed green |
|
|
| A picture out of Markdown takes the size of the family and stands centred, and both captions arrive, the one of the drawing and the one of the photograph; the photograph is made small enough to stay on the first page with its caption, the author stands under the title at the distance of the title block, and the heading over the first picture stands above it | the converter hands every picture to pandoc's own bound, and that is where the rules of the template hang; a photograph carries a mark in front of it and its paragraph lost its caption, and inside a figure the caption was not counted, so a picture made to fit moved and the page was stretched until a heading stood inside the picture |
|
|
| A page whose lying picture finds less than a quarter of the page moves the picture and keeps the rest empty: the picture is on the second page, and the author stands under the title at the distance of the title block (`short_page`) | a lying picture took whatever height was left and came out 60 points high in the last strip; a page left early was stretched past the play of its spaces, 48 points between title and author |
|
|
| The same document written in Markdown and in LaTeX carries its ink in the same places | both roads end in the same template, so a difference is a defect of the converter |
|
|
| The dollars inside a fenced code block reach the page | what stands there is an example of itself and is never repaired |
|
|
| A `latexmkrc` beside a document is not executed, and the document still builds | latexmk runs the Perl code of an rc file in its working directory, and the converter builds in the directory of the document |
|
|
| A package beside the document cannot start a program, and a control run without the converter can | the directory of the document is on the search path of the probe and of the build, and TeX Live allows `makeindex` and a few others in restricted mode; the control run proves that the check sees the program start |
|
|
| Two drawings called `mark.svg` in two folders give two converted files with different content, and a third picture of the first is converted no second time | named after the file alone, the second drawing overwrote the first in the build directory |
|
|
| An identity named through `TEXINPUTS` reaches the PDF, and a file of the same name beside the document does not | a company outside the TeX tree names its directory there; the fixture lies outside this repository, because until 2026-11-14 the converter searched the suite first and through every folder of it, and a fixture under `tests/build` was found there |
|
|
| The log of the probe names the file in the build directory of the converter, and the line it measured is the type area, while a `metrics.tex` lies on the search path of the caller (`own_probe`, F11.3) | the probe was run by its bare name, which xelatex looks up through the search path: a probe an earlier conversion left in this repository measured the example company for every company, and a head cell of a Pacta table stood 7 points past the edge of the page |
|
|
| A `fontspec.sty` that stops LaTeX, two folders below the document, leaves the document building; an identity two folders below the test builds of the suite is not found, and its log names the missing file (`subfolders`, F11.16) | the converter searched every folder below the document and below the suite before the TeX tree: in a checkout of 68377 folders one lookup of `fontspec.sty` took 257 seconds instead of 0.15, the probe of one PDF twelve and a half minutes, and a file below the document replaced the package of TeX Live |
|
|
| No line of that sentence ends with the hyphens a name begins with, and every name arrives whole (`leading_hyphens`, F11.5) | TeX breaks after a hyphen of its own accord, so a file with the right break points still broke `--size-medium` after its two hyphens; the first version of this check read the LaTeX, passed, and the page still ended a line with `--`, which is why it reads the page |
|
|
| A sentence of eleven inline code spans stays inside the text block, on the rendered page and in the build log (`code_line`, F11.5) | such a span is one word LaTeX may not hyphenate: a style guide listing the names of its convention had two lines 3.5 and 7.9 points past the edge, and the break the converter offers was reached only from sixteen characters up, so one name of the sentence broke and the shorter one beside it did not |
|
|
| On the page with the title block the head names the title; on the second page, which begins inside the first section, it names that section and not the title; and on a page that a section opens it names that section (`running_head`, F3.2) | whether a page begins before every section was asked of a mark that only a heading at the top of a page leaves, so every page of a document out of Markdown with a title carried the title in its head |
|
|
| The provider definition from an HTML table and the glossary definition from a Markdown table are named destinations; each receives one link from prose and one from an SVG drawing in the finished PDF (`linked_content`, F11.17) | the links were coloured in Markdown and in the drawing, while the LaTeX writer dropped the raw HTML anchors and the SVG conversion dropped the drawing annotations; checking source links or colours did not measure what the reader could click |
|
|
| An HTML table whose cell carries an `<iframe>` naming a page on a local server builds, its text arrives, the server is asked nothing and the page stays out of the PDF (`html_sandbox`, F11.14) | the HTML reader of pandoc fetched the address of an iframe and pasted the page into the table, so a document could make the converting machine ask an internal service or a tracking address |
|
|
| The pattern that tells a form from another document reads six lines right and a line of 100000 characters in under a second (`form_pattern`, F13.5) | `^.*\S.*:` tried every split of a line between its two `.*`: 3.6 seconds for 100000 characters, minutes for a megabyte of inline data on one line |
|
|
| With `--keep-tex`, a drawing that carried a link and then lost it carries no link in the second PDF, while the first carried one (`stale_links`, F11.17) | the drawings are numbered from one in every run and a drawing without links wrote no link file, so the file of the earlier drawing stayed and its links lay over the new picture |
|
|
|
|
## forms
|
|
|
|
`tests/forms.py`, 44 checks, on the PDF the converter produces from a sign-off chapter, from a document whose labels carry the characters of LaTeX, and from a document that carries no field at all. A form is only a form where somebody can tick a box, type an entry of any length and save the file, and nothing of that is visible on a rendered page: it is read out of the field dictionaries of the PDF.
|
|
|
|
| Measured | Why |
|
|
| --- | --- |
|
|
| Every field by its name: three boxes, six text fields, and no name used twice | the name travels into the PDF and is what whoever evaluates the filled file reads; an item without an identifier is named after its place, so a list written without identifiers still produces unique names |
|
|
| No `/MaxLen`, every text field with the multi-line flag, none with the one that forbids scrolling | «in any length» is three properties of the field, and a single-line field without scrolling cuts the entry off at the frame |
|
|
| `/NeedAppearances` set | it is what makes a reader draw what the partner types; without it a filled field can stay empty on the screen of the next reader |
|
|
| Exactly one box ticked, where one item was written ticked | `- [x]` is a ticked box on every platform, and the PDF has to arrive the same way |
|
|
| No field reaching past the text block | a field is furniture of the page like ink, and the single-line field ended 0.6 points over, the frame hyperref draws outside the width it is given |
|
|
| The large field at the end is several times the height of a remark, and the lines of a signature block begin on one edge | the large field takes whatever somebody writes, and «Name» and «Date» are both four letters and not the same width, so each label pushed its own frame to its own place |
|
|
| The build log of the fixture is kept and read | a conversion that throws its log away leaves the log of an earlier build to be measured, and the measurement then reports a state nobody has any more |
|
|
| Every item of a chapter of twelve stands on the page its label stands on | a box, its text and its field are one thing to read and one to fill in: item S7 of a sign-off chapter stood at the foot of page 4 and its frame began page 5, and the fixture of twelve items reproduces that at the same item |
|
|
| A label that closes a brace and asks for a file with `\input`, one with `%`, `&`, `#` and `_`, and one with `\textbf` build, stand on the page as written, and the file stays out of the PDF (`labels`, F13.4) | a label was written into the LaTeX as it stood: the first put the file into the PDF, the second stopped the build; the PDF of an earlier run is removed before each conversion, so a failed build is never measured on it |
|
|
| A document without a task list and without a label line carries no `/AcroForm` and no field | every other document of every company goes through the same converter, and the one thing this feature may not do is change them |
|
|
|
|
## logs
|
|
|
|
`tests/logs.py`, 694 checks over seventy logs. A build that ends with a PDF has not said that it went well.
|
|
|
|
Every log of every document this run built is read for: an error, an overfull box, a missing character, an undefined font shape, a substituted font, a head that is too small, a foot that is too small, a title block without an author, and a warning of hyperref.
|
|
|
|
Only the logs of this run are read. A log beside the examples was written by whatever state the working tree had when somebody last built there, and a defect repaired an hour ago still stands in it — measured on 2026-09-21, when a warning the fresh build no longer carried was reported from the build before it.
|
|
|
|
The probe of the converter is left out: it is run once, on purpose, to measure the width of a line, and it produces no page for any reader, so it always asks for the second run a document gets and a measurement does not need.
|
|
|
|
It found two more when the foot and the author were added to the list: every page of every example asked for 1.1 points more `\footskip` than the class gives, because only a foot with something in its inner corner was measured; and two documents set a title block without an author, which prints the block and leaves the line out.
|
|
|
|
It found the deck without a title on 2026-10-05: the kernel fills `\@title` and `\@author` with the command that complains about the omission, and the template handed that command to hyperref, which made it the title of the PDF and wrote its warning into the log of both deck fixtures. The two stores are now compared against what the kernel really puts there, read off a build — the title raises an error, the author only a warning, so the two do not have the same shape.
|
|
|
|
This measurement found four defects, three of them in changes made the same hour: the letter head of `g-brief2` asks for small capitals that the example face has none of; `bookmarks` set through `\hypersetup` after hyperref had read it, which warns in every log and changes nothing; the language set a second time over what babel had already given hyperref; and the one that would have been hard to find by eye — the option that asks for the identity alone still loaded `geometry`, which recomputes the page, so the logo in the head of the letter stood 49 points outside its field.
|
|
|
|
## Open measurements
|
|
|
|
- The presentation is built and read for errors, and of its slides only the ground and the sidebar are measured (`deck_ground`). The frame title, the blocks and the lists of a deck are judged by eye until a fixture says otherwise.
|
|
- The letter is built and read for errors; the position of the logo in its head, on the first page and on the pages after it, was judged on the rendered page and is not pinned by a measurement.
|