Perl extension properties

As mentioned above, any error arising from a Perl call will immediately halt the typesetting run. In effect the Perl extension forms part of the stylesheet, and stylesheet errors are considered fatal by TopLeaf. It is therefore essential to properly test Perl calls before running them in a production job.

However, during this testing it is sometimes useful to allow the typesetting to continue even when a Perl error occurs. For example, you may decide to test several Perl functions in a single run. TopLeaf therefore provides the following command:

<perl-properties fatal-errors="no"/>

which converts fatal errors to standard errors. The error will still appear in the log, but the typesetting will continue if possible.

[Note] Note

This command also causes any TopLeaf::fatal() calls in your Perl code to behave like TopLeaf::error().