← Back to branch summary

~ubuntu-branches/ubuntu/trusty/pyx/trusty

« back to all changes in this revision

Viewing changes to examples/text/texrunner.txt

  • Committer: Bazaar Package Importer
  • Author(s): Stuart Prescott
  • Date: 2011-05-20 00:13:52 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20110520001352-7jfc1unuvduxji05
Tags: 0.11.1-1
* New upstream release.
* Change documentation build system to sphinx in line with new upstream docs.
* Rebuild lfs files as part of build process.
* Refresh patchs for new version:
  - drop manual-latex-define.patch no longer needed with sphinx.
  - drop siteconfig-static.patch: not needed with new build system
  - drop pyx-text-warnings26.patch: warnings fixed upstream
* Add patch sphinx-mathjax.patch to use pngmath in sphinx rather than mathjax
  which is not yet in Debian.
* Add patch createlfs-no-foiltex.patch to skip generation of foiltex-based
  lfs files that would require non-free components.
* Switch to dpkg-source 3.0 (quilt) format.
* Switch from python-support to dh_python2 as build helper.
* Update copyright format to newer DEP-5 specification.
* Add new files to copyright file.
* Bump standards version to 3.9.2 (no changes required).
* Set DM-Upload-Allowed: yes

Show diffs side-by-side

added added

removed removed

Lines of Context:
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.