Asymptote bug (it's weird)

18 views
Skip to first unread message

Sean Fitzpatrick

unread,
Aug 18, 2026, 1:27:02 PM (5 days ago) Aug 18
to PreTeXt development
Recently we updated the Asymptote command used by the pretext script. 

The now-obsolete '-iconify' option was replaced by '-offscreen'.
This enables asymptote generation for anyone using GitHub codespaces. Great! 

Before changing, I tested the updated command on both Windows and Ubuntu, using several different versions of Asymptote. 

This week, I discovered that not all is well on Pop!_OS: the '-offscreen' option is being read as '-o ffscreen' for versions 3.11 and earlier. 

This obviously breaks the pretext script, since none of the files get the correct name. 

Mea culpa, I guess, although I'm hoping the Asymptote crowd can explain what's going on.
I'll go back and see if I can reproduce this in Ubuntu. If not, maybe something is weird with my laptop. 

Not sure what to suggest in the meantime. Changing back breaks codespaces. Nobody else complained so I'm hoping this is a 'just me' problem for now. 

Rob Beezer

unread,
Aug 19, 2026, 4:22:35 PM (4 days ago) Aug 19
to prete...@googlegroups.com
Discussion on this one has moved to an issue, which might become a PR shortly.

https://github.com/PreTeXtBook/pretext/issues/3161

If you want insight into our stance on releases, changes, and deprecations, you
could find the situation of interest.

Rob
> --
> You received this message because you are subscribed to the Google Groups
> "PreTeXt development" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> to pretext-dev...@googlegroups.com <mailto:pretext-
> dev+uns...@googlegroups.com>.
> To view this discussion visit https://groups.google.com/d/msgid/pretext-dev/
> CAH%2BNcPa6ujTyPknz_nLPWZ1XndkPcVzrLYVkB-EyBCtaUeh88A%40mail.gmail.com <https://
> groups.google.com/d/msgid/pretext-dev/CAH%2BNcPa6ujTyPknz_nLPWZ1XndkPcVzrLYVkB-
> EyBCtaUeh88A%40mail.gmail.com?utm_medium=email&utm_source=footer>.

Sean Fitzpatrick

unread,
Aug 19, 2026, 5:00:46 PM (4 days ago) Aug 19
to PreTeXt development
Anyone making use of 3D Asymptote might want to consider upgrading to the latest version (3.13).
The change to Vulkan rendering has advantages. But installing with this feature enabled can be non-trivial...

To unsubscribe from this group and stop receiving emails from it, send an email to pretext-dev...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/pretext-dev/MTAwMDA0d3JUTms2ajE.1787170951%40pnsh.

Rob Beezer

unread,
Aug 19, 2026, 10:27:59 PM (4 days ago) Aug 19
to prete...@googlegroups.com
A long battle with my assistant to clean this up. Asymptote always has
"-iconify" but "-offscreen" has come and gone. Finally got it to check all 147
versions of Asymptote. ;-)

+-----------------------------+------------+
| Asymptote version | option |
+-----------------------------+------------+
| 1.67 (2009) - 2.10 (2011) | -iconify |
| 2.11 (2011) - 2.65 (2020) | -offscreen |
| 2.66 (2020) - 3.11 (2026) | -iconify |
| 3.12 (2026) and later | -offscreen |
| version unreadable | -offscreen |
+-----------------------------+------------+

@Sean, you will want to read the commit, I think, just to stay in the know.

For more, see

https://github.com/PreTeXtBook/pretext/pull/3166


On 8/19/26 14:00, Sean Fitzpatrick wrote:
> Anyone making use of 3D Asymptote might want to consider upgrading to the latest
> version (3.13).
> The change to Vulkan rendering has advantages. But installing with this feature
> enabled can be non-trivial...
>
> On Wed, Aug 19, 2026, 2:22 p.m. 'Rob Beezer' via PreTeXt development <pretext-
> d...@googlegroups.com <mailto:prete...@googlegroups.com>> wrote:
>
> Discussion on this one has moved to an issue, which might become a PR shortly.
>
> https://github.com/PreTeXtBook/pretext/issues/3161 <https://github.com/
> PreTeXtBook/pretext/issues/3161>
> dev%2Bunsu...@googlegroups.com> <mailto:pretext- <mailto:pretext->
> > dev+uns...@googlegroups.com
> <mailto:dev%2Bunsu...@googlegroups.com>>.
> > To view this discussion visit https://groups.google.com/d/msgid/pretext-
> dev/ <https://groups.google.com/d/msgid/pretext-dev/>
> > CAH%2BNcPa6ujTyPknz_nLPWZ1XndkPcVzrLYVkB-EyBCtaUeh88A%40mail.gmail.com
> <http://40mail.gmail.com> <https://
> > groups.google.com/d/msgid/pretext-dev/
> CAH%2BNcPa6ujTyPknz_nLPWZ1XndkPcVzrLYVkB- <http://groups.google.com/d/msgid/
> pretext-dev/CAH%2BNcPa6ujTyPknz_nLPWZ1XndkPcVzrLYVkB->
> > EyBCtaUeh88A%40mail.gmail.com?utm_medium=email&utm_source=footer
> <http://40mail.gmail.com?utm_medium=email&utm_source=footer>>.
>
> --
> You received this message because you are subscribed to the Google Groups
> "PreTeXt development" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pretext-dev...@googlegroups.com <mailto:pretext-
> dev%2Bunsu...@googlegroups.com>.
> To view this discussion visit https://groups.google.com/d/msgid/pretext-dev/
> MTAwMDA0d3JUTms2ajE.1787170951%40pnsh <https://groups.google.com/d/msgid/
> pretext-dev/MTAwMDA0d3JUTms2ajE.1787170951%40pnsh>.
>
> --
> You received this message because you are subscribed to the Google Groups
> "PreTeXt development" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> CAH%2BNcPZ3cShA-agM7hw38Fm6M6WGL4NbXwDp%3DG15f9gj%3DRqZ_Q%40mail.gmail.com
> <https://groups.google.com/d/msgid/pretext-dev/CAH%2BNcPZ3cShA-
> agM7hw38Fm6M6WGL4NbXwDp%3DG15f9gj%3DRqZ_Q%40mail.gmail.com?
> utm_medium=email&utm_source=footer>.

Sean Fitzpatrick

unread,
Aug 20, 2026, 12:13:07 AM (4 days ago) Aug 20
to PreTeXt development
I'm planning to check this tomorrow when I'm more awake. 
Given the effort it took for me to get Asymptote 3.13 working on my System 76 laptop, I'm not sure I want to revert to an older version to test this out!

To unsubscribe from this group and stop receiving emails from it, send an email to pretext-dev...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/pretext-dev/MTAwMDA0MEFOV3JBbjQ.1787192876%40pnsh.

Rob Beezer

unread,
Aug 20, 2026, 10:20:38 PM (3 days ago) Aug 20
to prete...@googlegroups.com
*Some* checking would be nice, but don't go to the trouble of reverting! -Rob

On 8/19/26 21:12, Sean Fitzpatrick wrote:
> I'm planning to check this tomorrow when I'm more awake.
> Given the effort it took for me to get Asymptote 3.13 working on my System 76
> laptop, I'm not sure I want to revert to an older version to test this out!
>
> On Wed, Aug 19, 2026, 8:28 p.m. 'Rob Beezer' via PreTeXt development <pretext-
> d...@googlegroups.com <mailto:prete...@googlegroups.com>> wrote:
>
> A long battle with my assistant to clean this up.  Asymptote always has
> "-iconify" but "-offscreen" has come and gone.  Finally got it to check all 147
> versions of Asymptote.  ;-)
>
> +-----------------------------+------------+
> | Asymptote version           | option     |
> +-----------------------------+------------+
> | 1.67 (2009) - 2.10 (2011)   | -iconify   |
> | 2.11 (2011) - 2.65 (2020)   | -offscreen |
> | 2.66 (2020) - 3.11 (2026)   | -iconify   |
> | 3.12 (2026) and later       | -offscreen |
> | version unreadable          | -offscreen |
> +-----------------------------+------------+
>
> @Sean, you will want to read the commit, I think, just to stay in the know.
>
> For more, see
>
> https://github.com/PreTeXtBook/pretext/pull/3166 <https://github.com/
> PreTeXtBook/pretext/pull/3166>
>
>
> On 8/19/26 14:00, Sean Fitzpatrick wrote:
> > Anyone making use of 3D Asymptote might want to consider upgrading to the
> latest
> > version (3.13).
> > The change to Vulkan rendering has advantages. But installing with this
> feature
> > enabled can be non-trivial...
> >
> > On Wed, Aug 19, 2026, 2:22 p.m. 'Rob Beezer' via PreTeXt development
> <pretext-
> > d...@googlegroups.com <mailto:d...@googlegroups.com> <mailto:pretext-
> d...@googlegroups.com <mailto:prete...@googlegroups.com>>> wrote:
> >
> >     Discussion on this one has moved to an issue, which might become a PR
> shortly.
> >
> > https://github.com/PreTeXtBook/pretext/issues/3161 <https://github.com/
> PreTeXtBook/pretext/issues/3161> <https://github.com/ <https://github.com/>
> > dev%2Bunsu...@googlegroups.com
> <mailto:dev%252Buns...@googlegroups.com>> <mailto:pretext-
> <mailto:pretext-> <mailto:pretext- <mailto:pretext->>
> >      > dev+uns...@googlegroups.com
> <mailto:dev%2Bunsu...@googlegroups.com>
> >     <mailto:dev%2Bunsu...@googlegroups.com
> <mailto:dev%252Buns...@googlegroups.com>>>.
> >      > To view this discussion visit https://groups.google.com/d/msgid/
> pretext- <https://groups.google.com/d/msgid/pretext->
> >     dev/ <https://groups.google.com/d/msgid/pretext-dev/ <https://
> groups.google.com/d/msgid/pretext-dev/>>
> >      > CAH%2BNcPa6ujTyPknz_nLPWZ1XndkPcVzrLYVkB-
> EyBCtaUeh88A%40mail.gmail.com <http://40mail.gmail.com>
> >     <http://40mail.gmail.com <http://40mail.gmail.com>> <https://
> >      > groups.google.com/d/msgid/pretext-dev/ <http://groups.google.com/
> d/msgid/pretext-dev/>
> >     CAH%2BNcPa6ujTyPknz_nLPWZ1XndkPcVzrLYVkB- <http://groups.google.com/
> d/msgid/ <http://groups.google.com/d/msgid/>
> >     pretext-dev/CAH%2BNcPa6ujTyPknz_nLPWZ1XndkPcVzrLYVkB->
> >      > EyBCtaUeh88A%40mail.gmail.com?utm_medium=email&utm_source=footer
> <http://40mail.gmail.com?utm_medium=email&utm_source=footer>
> >     <http://40mail.gmail.com?utm_medium=email&utm_source=footer
> <http://40mail.gmail.com?utm_medium=email&utm_source=footer>>>.
> >
> >     --
> >     You received this message because you are subscribed to the Google Groups
> >     "PreTeXt development" group.
> >     To unsubscribe from this group and stop receiving emails from it, send an
> >     email to pretext-dev...@googlegroups.com <mailto:pretext-
> dev%2Bunsu...@googlegroups.com> <mailto:pretext- <mailto:pretext->
> > dev%2Bunsu...@googlegroups.com
> <mailto:dev%252Buns...@googlegroups.com>>.
> >     To view this discussion visit https://groups.google.com/d/msgid/
> pretext-dev/ <https://groups.google.com/d/msgid/pretext-dev/>
> >     MTAwMDA0d3JUTms2ajE.1787170951%40pnsh <https://groups.google.com/d/
> msgid/ <https://groups.google.com/d/msgid/>
> >     pretext-dev/MTAwMDA0d3JUTms2ajE.1787170951%40pnsh>.
> >
> > --
> > You received this message because you are subscribed to the Google Groups
> > "PreTeXt development" group.
> > To unsubscribe from this group and stop receiving emails from it, send an
> email
> > to pretext-dev...@googlegroups.com <mailto:pretext-
> > CAH%2BNcPZ3cShA-
> agM7hw38Fm6M6WGL4NbXwDp%3DG15f9gj%3DRqZ_Q%40mail.gmail.com
> <http://40mail.gmail.com>
> > <https://groups.google.com/d/msgid/pretext-dev/CAH%2BNcPZ3cShA- <https://
> groups.google.com/d/msgid/pretext-dev/CAH%2BNcPZ3cShA->
> > agM7hw38Fm6M6WGL4NbXwDp%3DG15f9gj%3DRqZ_Q%40mail.gmail.com
> <http://40mail.gmail.com>?
> > utm_medium=email&utm_source=footer>.
>
> --
> You received this message because you are subscribed to the Google Groups
> "PreTeXt development" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> MTAwMDA0MEFOV3JBbjQ.1787192876%40pnsh <https://groups.google.com/d/msgid/
> pretext-dev/MTAwMDA0MEFOV3JBbjQ.1787192876%40pnsh>.
>
> --
> You received this message because you are subscribed to the Google Groups
> "PreTeXt development" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> to pretext-dev...@googlegroups.com <mailto:pretext-
> dev+uns...@googlegroups.com>.
> To view this discussion visit https://groups.google.com/d/msgid/pretext-dev/
> CAH%2BNcPaJaFWWsxBX0Tui66BrQmx8dFivbaj_u--Yv99Svhz4Qg%40mail.gmail.com <https://
> groups.google.com/d/msgid/pretext-dev/CAH%2BNcPaJaFWWsxBX0Tui66BrQmx8dFivbaj_u--
> Yv99Svhz4Qg%40mail.gmail.com?utm_medium=email&utm_source=footer>.

Sean Fitzpatrick

unread,
Aug 20, 2026, 11:28:11 PM (3 days ago) Aug 20
to PreTeXt development
I pulled the latest and ran the pretext script. With 3.13 I was able to build everything with no errors. 

To unsubscribe from this group and stop receiving emails from it, send an email to pretext-dev...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/pretext-dev/MTAwMDAweG83dkNIRHc.1787278835%40pnsh.

Sean Fitzpatrick

unread,
Aug 21, 2026, 12:43:36 PM (2 days ago) Aug 21
to PreTeXt development
Testing now on my Runestone server, which still runs Asymptote 2.87.
Hit an error the first time around, because I haven't generated QR codes.
I admit I didn't think that Asymptote generation would need to look for YouTube QR codes, but apparently it does! Trying again once QR codes are built.

Sean Fitzpatrick

unread,
Aug 21, 2026, 1:58:50 PM (2 days ago) Aug 21
to PreTeXt development
Building asymptote to PDF is failing using pretext/pretext with Asymptote 2.87.
The script runs all right, but returns "The asymptote output ______ was not built" (fill in blank with appropriate file path).

Ahhh... but this is because I'm doing it on a headless server -- same issue we ran into on Codespaces: with no GPU or GUI, Asymptote tries to open a display, fails, and exits.
The correct command is being used, so I think we can at least conclude that the update to the build script is correct: the -offscreen option was only used for 3.13, while -iconify was used for 2.87.

Fortunately I don't need to build to PDF on Runestone, so this isn't a problem for me. Anyone else building PDF is hopefully either on codespaces (where Oscar can provide a recent Asymptote) or on their local machine (where Asymptote can open a display).
Reply all
Reply to author
Forward
0 new messages