examples/text/texrunner.txt

   1 Running and controlling TeX
   2
   3 ! Usually, all you will ever need is a single `texrunner` instance which
   4 controls a single running TeX or LaTeX instance at a time. To make life easy to
   5 our users..., such an instance is created automatically upon startup and its
   6 called the `defaulttexrunner`. Whenever you use the function shortcuts like
   7 `text.text()` and in particular `text.set()`, you are accessing this
   8 `defaulttexrunner` instance. Also, the shortcut method `text` of any canvas
   9 instance uses this `defaulttexrunner` by default.
  10
  11 !! However, it is possible to create several texrunner instances. In this
  12 example, we are using two of them. To make it a little more interesting, we
  13 instruct the `defaulttexrunner` to use LaTeX, while keeping TeX for the
  14 `plaintexrunner` instance. It is you turn to try expressions valid in TeX or
  15 LaTeX only at the different `texrunner` instances.
  16
  17 !! Note that you do not have to worry about mixing the results of different
  18 texrunners into a single output. Even the embedded fonts in the output are
  19 shared. You can, by the way, also restart a `texrunner` instance including the
  20 `defaulttexrunner` and change its configuration on that occasion.