docs/images/box.png

<EFBFBD>PNG


IHDR@<00>f<><66><05>IDATx<54><78><EFBFBD>1r7Б<>'b<>P<EFBFBD>`s<><73><EFBFBD><EFBFBD><EFBFBD>Hg`<60>0T<30>Lgr<67>*K<><4B><EFBFBD><EFBFBD><0C><><06><>Y<EFBFBD>v͟<76><19><>mض<><D8B6>)z	<09>.<2E><><EFBFBD><EFBFBD>Ob<0C><><EFBFBD>[1<>Jލ<4A>C
W<>*ÐڇUŐ׍<C590>cH<63><48>L<EFBFBD>1d<31>;<3B>2<0C><><EFBFBD>PC<>&<26>c<><63>0xbC<>ț<0C> <20>¦<EFBFBD><C2A6><EFBFBD><EFBFBD>c<>eX<65><58><18>*<19>fB⤊<42><E2A48A><EFBFBD> <20>1<1C>!?b;<3B>IN<49><4E>4<EFBFBD><34><EFBFBD><><7F>G<EFBFBD>u,<2C><><EFBFBD><EFBFBD><EFBFBD>%tq~><3E><<3C>F<EFBFBD><46><EFBFBD>K<EFBFBD>S-)<29>71<37><18>6<EFBFBD>L;<3B><><EFBFBD><05>h<EFBFBD><06><><EFBFBD>V<EFBFBD>`S<><53>J<EFBFBD>UY<55><59><EFBFBD><16><00><><EFBFBD><EFBFBD>:ӎ<>>SV<53>x<EFBFBD><78><EFBFBD>b<1E><>Xöm<C3B6><6D><EFBFBD>륍<EFBFBD>2<>|<7C>b<>1V<31>@<40>*<2A>c<EFBFBD>+/<2F>Lc<4C><63>үc<>H<EFBFBD><48>%<25><>f<EFBFBD><66>@ӌ<>De<44><65><EFBFBD>sy<73><1F><><EFBFBD>i<EFBFBD><69><EFBFBD>5<EFBFBD>'<27><><EFBFBD>'a<>=íf{0<><30>:<3A>M0<4D>l<EFBFBD>4<EFBFBD>y<>+/<2F><>c<EFBFBD><63>R<EFBFBD>%Î<>v*<2A><><EFBFBD>^I<>cx%<11>Ǝ<EFBFBD><C68E><EFBFBD><EFBFBD>_<EFBFBD>.]y<>c<><63>u<EFBFBD><75>U<EFBFBD>Z<><5A>`\<5C>:R):F<><46><EFBFBD><0C><><EFBFBD>)z<>eSq<53><71><EFBFBD><EFBFBD>d<EFBFBD><64><EFBFBD>K,<2C>+<2B>W<EFBFBD>+VGB<47>Ƙ<EFBFBD>Z<EFBFBD><5A>G<EFBFBD><47>ĂAҽ<41>*W9<><1A><>m<EFBFBD><6D>=C<>Ƶ<>#<23>BcT<63><54>EƸЕ<C6B8>Y<EFBFBD>1Jo?<3F>cl
<0A>b<EFBFBD>J]<5D>:<3A>+1F<31>;ƽU<C6BD>	z<>T<EFBFBD>:<3A><>?F<><1B><><EFBFBD><EFBFBD><EFBFBD>W^	<09><>(<28><><EFBFBD><EFBFBD><EFBFBD>K,<2C><><EFBFBD>|<7C><><EFBFBD>`<60><><EFBFBD>"<22>CR<43><52>=<05>_R<5F><52>	0dt<64><74>S<EFBFBD>y<EFBFBD><79><EFBFBD>_<EFBFBD><5F><EFBFBD>*<12><><EFBFBD>Q<EFBFBD><51>篁!<21><><EFBFBD>><02>[6υ0$r<><72>S<EFBFBD><53><0F>[<5B>C;<3B><><02><0F>w-	<09>?*J2FGG<47><47>J<1D>j<EFBFBD><6A>G<EFBFBD><47>6<EFBFBD><36><EFBFBD><18><1D>{
0<EFBFBD><EFBFBD>0<01>H<07><><02>:<3A><><EFBFBD>$<24><1F><05><><EFBFBD>Q<EFBFBD><51><EFBFBD><EFBFBD><EFBFBD><10><><EFBFBD>G<EFBFBD><47>e<EFBFBD><<01><00><><EFBFBD><02>(<28>;<01><><1A>=xE<78><45>ms<6D><73><EFBFBD><EFBFBD>1::<3A><>v<EFBFBD><18>i<EFBFBD><69><11><><EFBFBD><OF<4F>a<EFBFBD>wO^<5E><><EFBFBD><EFBFBD><00><08><><EFBFBD><02>
<EFBFBD><EFBFBD>[<5B><><EFBFBD>0FGG<47><47><EFBFBD>_C_]<5D>><?<3F><><EFBFBD>	0t<30><74><EFBFBD>)<29><>S<EFBFBD>s`<60>e<EFBFBD><65>S<EFBFBD>g<EFBFBD>~<7E><>1R]<5D>x~>9C
Q`<60><02>Ęs<C498><02><>D<EFBFBD>M<EFBFBD>a<EFBFBD>?C<><43>F<EFBFBD>rU<72>T<EFBFBD><54>n<><EFBFBD><7F><EFBFBD><EFBFBD>	{<7B><><EFBFBD><EFBFBD><EFBFBD>W;j<>M75F1<46><31><EFBFBD>H<05><><EFBFBD>1<EFBFBD>qC<71>'i<0B><><EFBFBD><EFBFBD><EFBFBD>˦:z!<0C><><EFBFBD>H2FU|P<><50>#񝣦<>$<24><><EFBFBD><12>Q<1B>+j\<5C><>y<EFBFBD><07>%$<24><><EFBFBD>2<EFBFBD>Qߢ<><DFA2>2_y<5F><79><1F>_;/<2F><><EFBFBD><EFBFBD>[s<>_%<25><1A>*<2A>Y<EFBFBD>4<EFBFBD><34><EFBFBD>><3E>J=<3D>ZՑV<D591>1<EFBFBD>q<EFBFBD><71><EFBFBD><19><><<18>W<EFBFBD>:<3A><>`<60><19>h<EFBFBD>><3E>W^s<>q<EFBFBD>u<>OjMv<><76><EFBFBD>Q<1D><><1B><>m<EFBFBD><6D><EFBFBD>9F<39>=_<><5F>a<EFBFBD><61>1<><18><><EFBFBD>l<1F>30y0Nm<4E><6D>i<>1N<31><4E><EFBFBD><EFBFBD><EFBFBD><EFBFBD>"W^oK<6F><4B>nr<><72>K,<2C><>U<EFBFBD>D<EFBFBD><44><EFBFBD>~<7E>c<><18>]<5D>&<26><><EFBFBD>xkVGs<47><73>1g^<5E>c$<24>9j:<3A>ӑ^<5E>:<1A><><EFBFBD>%z	)$<24><><EFBFBD><EFBFBD><EFBFBD>j=<3D>]<5D>-k<><6B>@%I<1E>3<EFBFBD><01><><EFBFBD><EFBFBD><EFBFBD>BQ1`hfp<66><70>Y<>]<0C><><EFBFBD>B_<42>b,<2C>0H<30><48>	0<>Ӷ<EFBFBD><D3B6><02><><EFBFBD>C<><43>1<EFBFBD>^<5E><>;<3B>)<29><>b<EFBFBD><62>\n<><6E><EFBFBD>BR<42><52>X<EFBFBD>!<21>+<11>^(<28>WU,<2C>PƛK/<2F><>o<EFBFBD><6F><07><>/<2F><><EFBFBD><EFBFBD><EFBFBD>V<EFBFBD><56>e<EFBFBD><65><EFBFBD><EFBFBD><EFBFBD>X<7F>᠃!<21><><19>0<01><>
`(L<><4C>0<01><>
`(L<><4C>0<01><>
`(L<><4C>0<01><>
`(L<><4C>0<01><>
`(L<><4C>0<01><>
`(L<><4C>0<01><>
{8<><38><EFBFBD><P<>?<3F>%<25>M<EFBFBD>$'<27>IEND<4E>B`<60>
-												Generate the documentation's figures from the listings they illustrate

Chapters 6 and 8 described what a verb draws in prose. Eight figures now show
it, and each one is produced by running the BASIC listing printed immediately
above it -- so a picture cannot drift away from the code beside it, which is the
way a screenshot goes wrong and the way nothing notices.

tools/screenshot.c is a second SDL host, much smaller than the frontend: dummy
video driver, software renderer, run to completion, read the target back, write
a PNG. It draws no text layer on purpose, so a READY in the corner is not noise
in a figure about BOX and no font has to be resolved.

tools/docs_screenshots.sh reads the new screenshot=NAME fence tag straight out
of the markdown. size=WxH is the second tag, and SCALE's figure uses it: the
point being made is a 320x200 listing filling a larger window, which cannot be
made on a 320x200 surface.

Two gates, answering different questions. docs_examples fails a tagged block
with no image, in both configurations, so a figure cannot be added and
forgotten. docs_screenshots -- a CTest, AKGL build only -- re-renders every
figure and compares byte for byte, so a listing edited without regenerating
fails. Only the second catches a stale picture.

The PNGs are checked in because a reader on the forge has no build tree, and
docs/images/README.md says loudly that they are generated. Regenerating is never
part of a build: the target is run deliberately, so a make cannot put eight
binary diffs in front of whoever ran it.

Drawing the BOX figure caught a defect in TODO.md itself. Deviation 16 claimed
in bold that BOX fills on a negative angle while its own paragraph said the fill
was filed rather than implemented. BOX cannot fill, and filled_rect is reached
by no verb as a result.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

											
										
										
											2026-08-01 07:37:04 -04:00
+								<EFBFBD>PNG
 IHDR@<00>f<><66><05>IDATx<54><78><EFBFBD>1r7Б<>'b<>P<EFBFBD>`s<><73><EFBFBD><EFBFBD><EFBFBD>Hg`<60>0T<30>Lgr<67>*K<><4B><EFBFBD><EFBFBD><0C><><06><>Y<EFBFBD>v͟<76><19><>mض<><D8B6>)z	<09>.<2E><><EFBFBD><EFBFBD>Ob<0C><><EFBFBD>[1<>Jލ<4A>C
W<>*ÐڇUŐ׍<C590>cH<63><48>L<EFBFBD>1d<31>;<3B>2<0C><><EFBFBD>PC<>&<26>c<><63>0xbC<>ț<0C> <20>¦<EFBFBD><C2A6><EFBFBD><EFBFBD>c<>eX<65><58><18>*<19>fB⤊<42><E2A48A><EFBFBD> <20>1<1C>!?b;<3B>IN<49><4E>4<EFBFBD><34><EFBFBD><><7F>G<EFBFBD>u,<2C><><EFBFBD><EFBFBD><EFBFBD>%tq~><3E><<3C>F<EFBFBD><46><EFBFBD>K<EFBFBD>S-)<29>71<37><18>6<EFBFBD>L;<3B><><EFBFBD><05>h<EFBFBD><06><><EFBFBD>V<EFBFBD>`S<><53>J<EFBFBD>UY<55><59><EFBFBD><16><00><><EFBFBD><EFBFBD>:ӎ<>>SV<53>x<EFBFBD><78><EFBFBD>b<1E><>Xöm<C3B6><6D><EFBFBD>륍<EFBFBD>2<>|<7C>b<>1V<31>@<40>*<2A>c<EFBFBD>+/<2F>Lc<4C><63>үc<>H<EFBFBD><48>%<25><>f<EFBFBD><66>@ӌ<>De<44><65><EFBFBD>sy<73><1F><><EFBFBD>i<EFBFBD><69><EFBFBD>5<EFBFBD>'<27><><EFBFBD>'a<>=íf{0<><30>:<3A>M0<4D>l<EFBFBD>4<EFBFBD>y<>+/<2F><>c<EFBFBD><63>R<EFBFBD>%Î<>v*<2A><><EFBFBD>^I<>cx%<11>Ǝ<EFBFBD><C68E><EFBFBD><EFBFBD>_<EFBFBD>.]y<>c<><63>u<EFBFBD><75>U<EFBFBD>Z<><5A>`\<5C>:R):F<><46><EFBFBD><0C><><EFBFBD>)z<>eSq<53><71><EFBFBD><EFBFBD>d<EFBFBD><64><EFBFBD>K,<2C>+<2B>W<EFBFBD>+VGB<47>Ƙ<EFBFBD>Z<EFBFBD><5A>G<EFBFBD><47>ĂAҽ<41>*W9<><1A><>m<EFBFBD><6D>=C<>Ƶ<>#<23>BcT<63><54>EƸЕ<C6B8>Y<EFBFBD>1Jo?<3F>cl
<0A>b<EFBFBD>J]<5D>:<3A>+1F<31>;ƽU<C6BD>	z<>T<EFBFBD>:<3A><>?F<><1B><><EFBFBD><EFBFBD><EFBFBD>W^	<09><>(<28><><EFBFBD><EFBFBD><EFBFBD>K,<2C><><EFBFBD>|<7C><><EFBFBD>`<60><><EFBFBD>"<22>CR<43><52>=<05>_R<5F><52>	0dt<64><74>S<EFBFBD>y<EFBFBD><79><EFBFBD>_<EFBFBD><5F><EFBFBD>*<12><><EFBFBD>Q<EFBFBD><51>篁!<21><><EFBFBD>><02>[6υ0$r<><72>S<EFBFBD><53><0F>[<5B>C;<3B><><02><0F>w-	<09>?*J2FGG<47><47>J<1D>j<EFBFBD><6A>G<EFBFBD><47>6<EFBFBD><36><EFBFBD><18><1D>{
 <EFBFBD><EFBFBD>0<01>H<07><><02>:<3A><><EFBFBD>$<24><1F><05><><EFBFBD>Q<EFBFBD><51><EFBFBD><EFBFBD><EFBFBD><10><><EFBFBD>G<EFBFBD><47>e<EFBFBD><<01><00><><EFBFBD><02>(<28>;<01><><1A>=xE<78><45>ms<6D><73><EFBFBD><EFBFBD>1::<3A><>v<EFBFBD><18>i<EFBFBD><69><11><><EFBFBD><OF<4F>a<EFBFBD>wO^<5E><><EFBFBD><EFBFBD><00><08><><EFBFBD><02>
 								<EFBFBD><EFBFBD>[<5B><><EFBFBD>0FGG<47><47><EFBFBD>_C_]<5D>><?<3F><><EFBFBD>	0t<30><74><EFBFBD>)<29><>S<EFBFBD>s`<60>e<EFBFBD><65>S<EFBFBD>g<EFBFBD>~<7E><>1R]<5D>x~>9C
 								Q`<60><02>Ęs<C498><02><>D<EFBFBD>M<EFBFBD>a<EFBFBD>?C<><43>F<EFBFBD>rU<72>T<EFBFBD><54>n<><EFBFBD><7F><EFBFBD><EFBFBD>	{<7B><><EFBFBD><EFBFBD><EFBFBD>W;j<>M75F1<46><31><EFBFBD>H<05><><EFBFBD>1<EFBFBD>qC<71>'i<0B><><EFBFBD><EFBFBD><EFBFBD>˦:z!<0C><><EFBFBD>H2FU|P<><50>#񝣦<>$<24><><EFBFBD><12>Q<1B>+j\<5C><>y<EFBFBD><07>%$<24><><EFBFBD>2<EFBFBD>Qߢ<><DFA2>2_y<5F><79><1F>_;/<2F><><EFBFBD><EFBFBD>[s<>_%<25><1A>*<2A>Y<EFBFBD>4<EFBFBD><34><EFBFBD>><3E>J=<3D>ZՑV<D591>1<EFBFBD>q<EFBFBD><71><EFBFBD><19><><<18>W<EFBFBD>:<3A><>`<60><19>h<EFBFBD>><3E>W^s<>q<EFBFBD>u<>OjMv<><76><EFBFBD>Q<1D><><1B><>m<EFBFBD><6D><EFBFBD>9F<39>=_<><5F>a<EFBFBD><61>1<><18><><EFBFBD>l<1F>30y0Nm<4E><6D>i<>1N<31><4E><EFBFBD><EFBFBD><EFBFBD><EFBFBD>"W^oK<6F><4B>nr<><72>K,<2C><>U<EFBFBD>D<EFBFBD><44><EFBFBD>~<7E>c<><18>]<5D>&<26><><EFBFBD>xkVGs<47><73>1g^<5E>c$<24>9j:<3A>ӑ^<5E>:<1A><><EFBFBD>%z	)$<24><><EFBFBD><EFBFBD><EFBFBD>j=<3D>]<5D>-k<><6B>@%I<1E>3<EFBFBD><01><><EFBFBD><EFBFBD><EFBFBD>BQ1`hfp<66><70>Y<>]<0C><><EFBFBD>B_<42>b,<2C>0H<30><48>	0<>Ӷ<EFBFBD><D3B6><02><><EFBFBD>C<><43>1<EFBFBD>^<5E><>;<3B>)<29><>b<EFBFBD><62>\n<><6E><EFBFBD>BR<42><52>X<EFBFBD>!<21>+<11>^(<28>WU,<2C>PƛK/<2F><>o<EFBFBD><6F><07><>/<2F><><EFBFBD><EFBFBD><EFBFBD>V<EFBFBD><56>e<EFBFBD><65><EFBFBD><EFBFBD><EFBFBD>X<7F>᠃!<21><><19>0<01><>
 								`(L<><4C>0<01><>
 								`(L<><4C>0<01><>
 								`(L<><4C>0<01><>
 								`(L<><4C>0<01><>
 								`(L<><4C>0<01><>
 								`(L<><4C>0<01><>
 								{8<><38><EFBFBD><P<>?<3F>%<25>M<EFBFBD>$'<27>IEND<4E>B`<60>