fix race condition by Michael J Gruber
[PyX/mjg.git] / CHANGES
blob60b2afcb4ad24e925a53eeed28a394d26a938443
1 PyX
3 TODO:
4   - style module:
5     - make dash length available
6   - text module:
7     - repair PDF generation with unincluded standard fonts (currently broken)
8     - SlantFont & Co support
9     - keep an eye on PEP 324 (popen 5): it could make the texrunner much easier
10     - discuss reltransform: https://sourceforge.net/mailarchive/forum.php?thread_id=9137692&forum_id=23700
11     - add encoding; check whether encoding=ascii works well for the common existing cases
12     - write graphics driver for pgf.sty from LaTeX
13     - ignore "(Please type a command or say `\end')" in preamble method
14     - properly handle file names with spaces in (like "C:\program files\texmf\tex\latex\base\article.cls" in
15       texmessage.load
16   - graph.graph module
17     - common bboxes for different graphs
18     - 3d graphs, circular graphs
19     - axis painter labelattrs=None + automatic axis partitioning leads to no valid partitioning
20     - when all titles are None, a graph key currently raises an exception
21     - translatecanvas should be the default in graph.style.symbol
22     - automatic scaling of y-axis according to subset of data shown on x-axis
23     - graph.axis.timeaxis.timetick must not override datetime.datetime __init__ method (since datetime.datetime
24       instances are immutable like ints)
25   - graph.style and graph.data modules
26     - fix docu of gridattrs functionality of axis painters
27       (how can one, e.g. draw a grid at the ticks and not at the subticks)
28     - make graph.style.symbol.diamond a graph.style.symbol instance (to be discussed)
29   - graph.data module:
30     - use csv module (new in 2.3)
31     - Check for "inf" and "nan" in datafiles.
32       (When plotted, the graph does not complain, but the output will be broken;
33       this depends on the plattform and is not only an issue within the graph system)
34   - graph.style module:
35     - add styles using curves instead of lines
36   - graph.texter module:
37     - rename period argument of decimal texters to recurring_decimal or something similar (as pointed out
38       by Tim Head)
39   - canvas module:
40     - contructor should only take a texrunner keyword argument
41     - SVG support
42     - stroking of patterns does not work in PDF
43   - style and color module:
44     - support modification of existing styles via __call__
45   - bitmap module:
46     - ReusableStreamDecode?
47     - proper ASCII85Decode/HexDecode switch
48     - Support for transparent bitmaps?
49   - bbox module:
50     - rewrite height, etc. using properties
51   - dvifile module:
52     - support single-character mode
53     - fix problem reported by Gert Ingold: http://sourceforge.net/mailarchive/forum.php?thread_name=20090323081817.GA34112%40physik.uni-augsburg.de&forum_name=pyx-user
54   - deformer module:
55     - move helper path routines to some more generic place for paths?
56   - pdffile module needed (similar to epsfile)
57   - open discussion:
58     - clearly distingish between readers and writers. dvifile, epsfile, etc. might
59       be renamed to dvireader, epsreader ...
60     - support gsave and grestore in some way to make context handling easier?
61   - ps/pdfwriters:
62     - support colorspace argument (like c.writeEPSfile("bla", colorspace="cmyk"))
63   - move pyx.def, lfs-files etc. into a new share directory
64   - write fakepattern.py which substitutes some of the pattern functionality using
65     re-usable canvases
66   - libkpathsea bindung:
67     - create a ctypes based binding to replace the extension module implementation in the long
69   Documentation:
70     - path module:
71       - describe + vs << vs join
72       - more details in path constructor: allowed pathels, first pathel...
73       - set method
74     - pattern module:
75       - check and update
76     - graphics section:
77       Changeable attributes should be explained at a central place.
78     - box module:
79       - linealign and circlealign
80       - need to be redone anyway
81     - graph module:
82       styles: document what data name the styles accept (require). Try also to be more
83       userfriendly and not to describe immediately the internals of the implementation:
84       (see e.g. class.style.symbol)
85     - document interface to access tick positions
87   Examples:
88     - add an epsfile example (suggested by Stathis Sideris)
89     - add a small example line on y="f($1)" in one of the plot examples
90     - add a grid example
92   FAQ:
93     - describe creation and modification (inplace and ``modify by new'') of
94       graph data
97 0.11 (2008/xx/xx):
98   - font and dvi modules:
99     - major reorganization
100     - TeX mapping files are a property of the writer now (TODO: documentation)
101       By that the pdfwriter now uses pdftex.map instead of psfonts.map
102       (It's also possible to pass a fontmap to a texrunners text method to use
103       different mappings within a single output file)
104     - support for font matrices (afm) for Type1 fonts
105       (using fonts without a metrics is still supported, but properly issues
106       a warning now)
107     - interface for basic TeX-less text output
108     - new PS and PDF writer options: strip_fonts, text_as_path, mesh_as_bitmap,
109       mesh_as_bitmap_resolution (TODO: documentation)
110     - fix for commented out UniqueID
111   - graph modules:
112     - bar style on graphxyz (single datasets only)
113     - graphxyz:
114       - fix position of z4 axis
115       - set correct errorname for z axis (thanks to Axel Freyn)
116       - fix wrong y value usage instead of z value in pos methods
117     - fix unused color range settings in surface style (thanks to Michael J Gruber)
118     - fallbackrange for axes with vanishing range
119     - dokeyitem method (to be called with a plotitem) to alter the key order
120     - doplot() was renamed to doplotitem(), dodata() was renamed to doplot()
121       to have similar naming conventions like for the graph key
122     - axis painter: properly rotate axis titles when ticks are not othorgonal
123       to the axis (reported by Christian Delfosse)
124     - graph.style.arrow: decorator is an parameter of the constructor now
125       (thanks to Axel Freyn)
126     - remove ticks with unset ticklevel and labellevel to prevent rating failures
127       (thanks to Brendon Higgins)
128   - canvas and document modules:
129     - auto-guess output filename from the script filename
130     - add ciecolor flag and input type to the pipeGS method of canvas
131   - config module:
132     - psfontmaps and pdffontmaps config options (TODO: documentation)
133     - config option for format warnings
134   - text module:
135     - fix two bugs in the read pipe of the texrunner (thanks to
136       Laurence Tratt and Eric Faurot)
137     - fix "<" token handling in mapping file parser (thanks to Matthew West)
138     - fix start message parse error in MiKTeX (thanks to Wojciech Jaskowski)
139     - fix rigid aux file checking (thanks to Clayton E. Myers)
140     - use subprocess module if available
141     - proper error messages when TeX is stopped due to unrecoverable error
142   - style module:
143     - implement style.fillrule
144   - deco module:
145     - added an explicit hatch pattern as an alternative for real postscript patterns
146   - bitmap module:
147     - add support for transparent bitmaps (in postscript stencil masking only)
148   - path and normpath modules:
149     - remove incorrect zero length line in PDF output for each first moveto
150       path element (thanks to Michael J Gruber)
151     - raise correct normpath exception (thanks to Axel Freyn)
152   - epsfile module:
153     - an ugly way to import EPS in PDF using a bitmap (requires PIL)
156 0.10 (2007/10/03):
157   - graph modules:
158     - graph module:
159       - graphxyz for 3d graphs with parallel and central projection
160       - doplot method (to be called with a plotitem) to alter the plotitem order etc.
161     - graph styles:
162       - new surface style for 3d graphs (colored surfaces are functional
163         (and useful!) for 2d graphs as well)
164       - new grid style for 3d graphs
165       - new impulses style
166       - optional textdx/textdy columns to the text style added
167       - arrowpos parameter to the arrow style added
168       - bugfix: fromvalue axis range adjustment in histogram style
169       - bugfix: axis range adjustment in range style
170     - axis module:
171       - painter: don't insert axis title twice (thanks to Tim Gray for reporting this problem)
172       - parter: extend the logarithmic parter to calculate automatic partitions for huge ranges
173         (TODO: documentation of the new autoexponent parameter) (suggested by Dominic Ford)
174       - fix: range rating was not taken into account due in the 0.9 release
175     - data module:
176       - list class was renamed to points; deprecation warning added
177         for instance creation, but inheritance from list failes
178       - new values class
179   - new mesh module:
180     - internal helper module for efficient handling of triangular colored meshs
181   - color module:
182     - renamed: palette->gradient, functionpalette->functiongradient, linearpalette->lineargradient
183     - new class palette representing a discrete ordered list of colors
184     - support transparency for filling/stroking in pdf separately
185     - transparency support for postscript as available by means of a proprietary
186       ghostscript extension (for ps2pdf)
187   - attr module:
188     - add multichangeattr to perform a select on different changeable attributes
189       depending on the selects total number
190   - font modules:
191     - t1font:
192       - add missing glyph traversal in t1seacs updatepath
193   - normpath module:
194     - support zero-length normsubpaths
195   - canvas module:
196     - don't change order of attrs passed to canvas constructor in place
197   - added __truediv__ methods according to PEP 238
200 0.9 (2006/05/24):
201   - most important changes (to be included in the release notes):
202     - mathtree removal (warning about integer division)
203     - barpos style does not build tuples for nestedbar axes automatically
204     - new deformers for path manipulation (for smoothing, shifting, ... paths)
205   - font modules:
206     - new framework for font handling
207     - own implementation of type1 font stripping (old pdftex code fragments removed)
208     - complete type1 font command representation and glyph path extraction from font programs
209     - t1code extension module (C version of de-/encoding routines used in Type 1 font files)
210     - AFM file parser
211   - graph modules:
212     - data module:
213       - mathtree removal: more flexibility due to true python expressions
214       - default style instantiation bug (reported by Gregory Novak)
215     - style module:
216       - automatic subaxis tuple creation removed in barpos (create tuples
217         in expressions now; subnames argument removed since it became pointless;
218         adujstaxis became independend from selectstyle for all styles now)
219       - remove multiple painting of frompath in histogram and barpos styles
220       - fix missing attribute select when using a bar style once only (reported by Alan Isaac)
221       - fix histograms for negative y-coordinates (reported by Dominic Ford, bug #1492548)
222       - fix histogram to stroke lines to the baseline for steps=0 when two subsequent values are equal
223       - add key method for histogram style (reported by Hagemann, bug #1371554)
224       - implement a changebar style
225     - graph, axis and style module:
226       - support for mutual linking of axes between graphs
227       - new domethods dependency handling
228       - separate axis range calculation from dolayout
229     - axis.parter module:
230       - linear and logarthmic partitioners always need lists now
231         (as it was documented all the time; renamed tickdist/labeldist
232         to tickdists/labeldists; renamed tickpos/labelpos to
233         tickpreexps/labelpreexps)
234     - axis module:
235       - patch to tickpos and vtickpos (reported by Wojciech Smigaj, cf. patch #1286112)
236       - anchoredpathaxis added (suggested by Wojciech Smigaj)
237       - properly handle range rating on inversed axis (reported by Dominic Ford, cf. bug #1461513)
238       - invalidate axis partitions with a single label only by the distance rater
239       - fallback (with warning) to linear partitioner on a small logarithmics scale
240     - painter module:
241       - patch to allow for tickattrs=None (reported by Wojciech Smigaj, cf. patch #1286116)
242   - color module:
243     - transparency support (PDF only)
244     - conversion between colorspaces
245     - nonlinear palettes added
246     - the former palette must now be initialized as linearpalette
247     - remove min and max arguments of palettes
248   - text module:
249     - improve escapestring to handle all ascii characters
250     - correct vshift when text size is modified by a text.size instance
251     - recover from exceptions (reported by Alan Isaac)
252     - handle missing italic angle information in tfm for pdf output (reported by Brett Calcott)
253     - allow for .def and .fd files in texmessage.loaddef (new name for
254       texmessage.loadfd, which was restricted to .fd files)
255   - path module:
256     - correct closepath (do not invalidate currentpoint but set it to the
257       beginning of the current subpath); structural rework of pathitems
258     - calculate real bboxes for Bezier curves
259     - fix intersection due to non-linear parametrization of bezier curves
260     - add rotate methods to path, normpath, normsubpath, and normsubpathitems
261     - add flushskippedline to normsubpath
262     - add arclentoparam to normsubpath and normsubpathitems
263     - path is no longer a canvasitem
264     - reduce number of parameters of outputPS/outputPDF methods (do not pass context and registry)
265   - normpath module:
266     - contains normpath, normsubpath and normpathparam which have originally
267       been in the path module
268     - return "invalid" for certain path operations when the curve "speed" is
269       below a certain threshold
270     - normpath is no longer a canvasitem
271     - reduce number of parameters of outputPS/outputPDF methods (do not pass context and registry)
272   - deformer module:
273     - rewritten smoothed to make use of the subnormpath facilities
274     - rewritten parallel for arbitrary paths
275   - deco module:
276     - add basic text decorator
277     - allow arrows at arbitrary positions along the path
278   - connector module:
279     - boxdists parameter need to be a list/tuple of two items now
280     - changed the orientation of the angle parameters
281   - trafo module:
282     - renamed _apply to apply_pt
283     - introduce _epsilon for checking the singularity of a trafo
284   - epsfile module:
285     - use rectclip instead of clip to remove the clipping path from the
286       PostScript stack, which otherwise might create strange effects for
287       certain PostScript files (reported by Gert Ingold)
288   - dvifile module:
289     - silently ignore TrueType fonts in font mapping files (reported by Gabriel Vasseur)
290   - type1font module:
291     - accept [ and ] as separators in encoding files (reported by Mojca Miklavec, cf. bug #1429524)
292   - canvas module:
293     - remove registerPS/registerPDF in favour of registering resourcing during the outputPS/outputPDF run
294     - move bbox handling to registry
295     - rename outputPS/outputPDF -> processPS/processPDF
296     - remove set method of canvas
297     - add a pipeGS method to directly pass the PyX output to ghostscript
298     - allow file instances as parameter of the writeXXXfile methods (feature request #1419658 by Jason Pratt)
299   - document modules:
300     - allow file instances as parameter of the writeXXXfile methods (feature request #1419658 by Jason Pratt)
301   - style module:
302     - make rellength the default for dash styles
303   - random notes:
304     - switched to subversion on 2006/03/09
306 0.8.1 (2005/08/13):
307   - deco module:
308     - fix bug in postscript deco code for stroking only attributes
309   - path module:
310     - fix multicurveto._normalized
311     - fix path.paramtoarclen and path.paramtoarclen_pt 
312     - remove unused method-local function
313     - fix linestyle rellength in PostScript
314     - correction to the rounding problems in circles (reported by Uwe Fabricius)
315   - epsfile module:
316     - fix a typo
317   - pattern module:
318     - issue a warning when not using a stroke color for patterns
319   - text module:
320     - postpone PDFfontdescriptor information, since it raises an error on certain
321       fonts even when PostScript output was requested (reported by Gert Ingold)
322     - remove spurious spaces when checking for empty texmessages
323   - kpathsea module:
324     - caching in fallback to lower system call bottleneck
325   - canvas module:
326     - add missing writePSfile wrapper
327     - add *args to writeEPSfile and writePDFfile wrappers
328   - writer modules:
329     - writebbox option to write bbox information (disabled by default)
330       even when a paper format is specified (PS and PDF writers only)
331   - use arclen in spring example
332   - add knot example
333   - use pdf graphic files for pdf version of the manual
334   - use PyX to create tipa fallbacks for FAQ
335   - correct description regarding the manual in the README file
338 0.8 (2005/07/13):
339   - changed requirements to python 2.1 or newer:
340     - nested scopes are needed without fallback solution by the path module
341       (at other places fallback solutions for missing nested scopes are missing as well)
342     - use warning module for warnings
343   - path module:
344     - path parameters and argument handling
345     - the arct to arc/arcn conversion (needed for bbox calculation and for conversion into
346       normpath) has been fixed
347   - document module: new
348     - container classes for document and pages
349     - document.paperformat class (strings are deprecated)
350   - canvas module:
351     - writeEPSfile wraps a canvas in a single page document and performs the output
352   - bbox module:
353     - add _pt methods
354   - pdfwriter module:
355     - completely rewritten: support for fonts and patterns has been added
356   - pswriter module: new
357     - separate PS output from canvas
358     - new signature of outputPS methods: writer and context are passed as additional
359       arguments
360   - color module:
361     - allow selection on zero range palette (reported by Francisco Borges, cf. bug #1116257)
362   - prolog module: removed due to code reorganisation
363   - graph modules:
364     - modifications on __init__.py in graph and axis subdirectories to
365       make "from pyx.graph import *" working as expected
366     - graph styles:
367       - addontop added to stackedbarpos
368       - column -> columnname renaming where appropriate
369       - histogram style added
370     - graph data:
371       - function needs explicit variable definition (implicit variable definition is deprecated)
372       - column names are inherited by data.data() except when copy=0;
373         unused columns are silently ignored now
374       - dynamic function data on a logarithmic axis uses isinstance check now
375         (although it removes the only (mis)use of axis.inverse, it is a
376         temporary solution only)
377     - graph key:
378       - extend graph keys to allow for several columns
379     - axis data handling refactoring:
380       - introcuded an axis positioner (module graph.axis.positioner)
381       - introduced anchoredaxis to make axis data and positioning local to a graph
382       - linkedaxis is a special version of anchoredaxis and is generic
383         (it uses the new linkpainter provided by an axis)
384       - unification of split and bar axes;
385         removed some black magic in baraxis in favor of a nestedbar axis
386       - x linked to x2 etc. is now possible
387       - axis.inverse was removed (the only place it was (mis)used was by a function)
388     - graphxy:
389       - allow to transform axis after layout
390       - [xy]axisat arguments in the constructor to easily move [xy]-axes
391         to a position defined the orthogonal axis
392       - remove axispos (use the axis dictionary now, since it now contains
393         anchored axis instances and those have shortcuts for the axis positioner
394         methods)
395   - dvifile:
396     - tfm->dvi conversion rounding bugfix
397     - fix parsing of empty strings ("") in fontmap files (reported by John Owens, bug #1218983)
398   - text module:
399     - support for halign of boxes and content of boxes (see halign example)
400     - take units xscale into account in parbox
401     - messageparser for replaced fontsizes: Warning -> implemented by texmessage.fontwarning
402     - messageparser for size differences at the end: Warning not Exception -> implemented by texmessage.fontwarning
403     - messageparser for overfull/underfull vbox/hbox: Warning not Exception -> implemented by texmessage.boxwarning
404     - dvicopy flag removed
405     - allow argument of set to be None
406     - rename nomathmode and nophantom to clearmathmode and clearphantom
407     - texmessagepattern for easy creation of simple TeX message parsers
408     - allow long file names in file checking TeX message parsers
409     - no newline removal to not disturbe TeX messages when reporting errors
410     - reworked documentation to use the python documentation standards
411   - style module:
412     - linewidth is no longer a unit.length subclass but expects a such as first argument
413   - epsfile module:
414     - correct EOL handling while reading DSC's (reported by Markus Meyer)
415   - pattern module: new
416     - moved canvas.pattern to its own module together with the new PDFpattern class
417     - add some default patterns: hatched and crosshatched
418   - deformer module:
419     - improve the smoothing deformer
420     - add a parallel deformer
421   - tex module:
422     - the very old tex module finally got removed completely
423   - contrib directory:
424     - a simple converter from dvi to EPS/PS/PDF files (dviconvert.py) has been added
425     - a simple imagine to EPS/PS/PDF converter (imgconvert.py) has been added
426     - a simple dvitype.py has been added
427   - update address of FSF all over the place
430 0.7.1 (2004/12/15):
431   - canvas module:
432     - EPS header fixed (reported by Russell Lang, cf. bug #1065099)
433   - Makefile fixes:
434     - use CURDIR instead of PWD (reported by David M. Cooke, bug #1070285)
435   - pykpathsea module:
436     - support windows line endings (patch by Hans-Andreas Engel, cf. bug #1071160)
437   - graph modules:
438     - line attributes handling fixed (reported by Andrea Riciputi)
439     - fix typos in predefined symbols (reported by Andrea Riciputi)
440     - cut column name list at the max. number of columns (reported by Arnd Baecker)
441   - examples:
442     - add INDEX and README files to distribution
443     - new errorbar and julia example
444   - faq:
445     - pdf snippets for tipa based phonetic transliterations
448 0.7 (2004/10/21):
449   - bitmap module:
450     - new module for inclusion of bitmap images
451   - path module:
452     - names of local and member variables now follow the naming convention of
453       having a _pt suffix when containing lengths in points
454   - bbox module:
455     - names of local and member variables now follow the naming convention of
456       having a _pt suffix when containing lengths in points
457     - enlarge was misspelled as enlarged
458     - renamed _bbox -> bbox_pt
459     - new bbox method center, which returns the coordinates of the center
460       of the bbox
461     - enlarge and enlarged do no longer interprete unqualified lengths as
462       being of type visual
463   - unit module:
464     - unit.cm, unit.t_cm, etc. are no longer sub classes but instances
465       of length
466     - never convert implicitly into visual/width, etc. lengths (this is more
467       about usage of the unit module in various other modules) (TODO: update
468       documentation)
469     - support for string initialization removed
470     - support for initialisation with other length removed
471     - lengths can now be divided by other lengths (as suggested by Michael Gruber
472       and Magnus Lie Hetland)
473   - text module:
474     - postpone reading of fontmap files until TeX/LaTeX is started
475     - sign of font number in dvifile (reported by Michael Gruber)
476     - phantom attribute
477   - canvas module:
478     - added new classes page and document for multipage PostScript output
479     - apply deformers (instead of trafos) in draw method
480   - style module:
481     - decrease interval for dotted and dash-dotted lines for better visual
482       appearance
483   - setup.py and distribution:
484     - create siteconfig on install to store positions of the shared data
485       and the global pyxrc
486   - graph modules:
487     - graph style + data reorganization
488       - modularization of the graph styles by separating data handling and drawing tasks
489       - several graph styles can now be combined together
490       - graph data can internally now combine different data sources
491         (by that, some nasty side effects could have been removed)
492     - enum -> num renaming
493     - allow for horizontally and vertically centered graph key alignment and a key background
494     - fix bug that graph was not finished automatically when a bbox was specified
495       manually (reported by David Barton)
496   - path module:
497     - pathel -> pathitem, etc. renaming
498     - methods accepting a parameter value / arc length now also allow the user to 
499       pass a tuple (subpath, param) / (subpath, arclen)
500     - normpath constructor no longer accepts a path or normpath as argument but only a list
501       of normsubpaths. Use the new normpath method of the path instead to construct a normpath
502       from a path.
503     - normsubpath can now deal with short (i.e. shorter than epsilon) segments correctly
504     - the intersect and split methods of normpath and normsubpath have been completely rewritten and
505       now take the accuracy epsilon correctly into account. Note that for a closed subpath the
506       split function now returns the segment containing the closing point as first element
507       in the result list (before, it was returned as last element).
508     - normsubpathitems and normsubpath now implement much more methods also provided by
509       path and normpath instances
510     - normpath.append no longer accepts pathitems but only normsubpaths
511   - deformer module: new
512     - moved cycloid and smoothed from deco into deformer
513   - bbox module:
514     - handle "BoundingBox: (atend)" (cf. bug #945621 reported by Jim Boyle)
515     - kpsearch option to search for file using the kpathsea library (contributed by Michael Gruber)
516   - base module:
517     - PSCmd and PSOp are now joined in a new class canvasitem
518   - deco module: 
519     - decorated path no longer allows modification of its path
520     - new method excluderange which allows to remove certain parameter ranges from the stroked path
521     - additional canvas provided by decorated path is now called ornaments
522     - constriction=None now indicates an arrowhead without constriction
523   - trafo module:
524     - trafos are now deformers
525   - examples:
526     - a bunch of bargraph examples have been added
529 0.6.x (????/??/??):
530    - graph/axis module:
531      - fix errorbar range adjustment
532      - fix empty tick lists bug (reported by Marko Vendelin, cf. bug #977323)
533    - graph/style module:
534      - symbolline drawing order in graph key (cf. bug #990687)
535    - graph/data module:
536      - access to builtin list (reported by Marcus Mendenhall, cf. bug #1042458)
539 0.6.3 (2004/04/27):
540    - graph module:
541      - fix drawing with background
542      - fix insertion of a zero length path when the whole line is outside
543        the valid axis range (reported by Marko Vendelin)
544    - distribution:
545      - include source for faq and manual
546      - distribute the pdf instead of postscript (manual, faq, examples)
549 0.6.2 (2004/04/07):
550   - graph module:
551     - fixed title=None + graph key issue reported by Gabriel Vasseur
552     - graph.axis.painter.plain -> graph.axis.painter.regular
553       (as it was in parts of the documentation already)
554     - changeable-gridattrs-become-None-bug fixed
555     - graph style cutting outside lines (double-)fixed
558 0.6.1 (2004/03/31):
559   - fixes missing install of the graph and axis directories introduced in 0.6
560   - some minor updates to the faq
563 0.6 (2004/03/30):
564   - graph module:
565     - reorganisation of the graph structure finished (there might be some
566       small pending issues, but the basic restructuring is done with this release):
567       - graph splitted into several modules in pyx/graph and pyx/graph/axis
568       - painters are using the new attribute scheme including changeable
569         attributes
570       - graph styles rewrite
571       - graph data rewrite
572     - axis zeropath feature has been removed
573     - mergelabels removed; linpart doesn't have a label argument anymore
574     - names and texts removed from baraxis
575     - iteration on graph style, when it is used several times in the same graph
576     - symbols + lines -> symbollines; symbols do not allow setting lineattrs,
577       and lines not symbolattrs
578     - manual line clipping (do not include unneeded line segments when the
579       axis range is set manually etc.)
580     - automatic file key titles
581     - graph.data now also includes the old data module
582     - data.list adds (by default) a line number like data.file
583       (thus regular columns are counted from 1)
584   - path:
585     - added new pathels multilineto_pt and multicurveto which allows to specify
586       a list of points and can thus be much more efficient
587     - internal methods return coordinates in pts
588     - arclentoparam returns only parameters not total length
589     - added path.arclength_pt, path.at_pt, path.begin_pt, path.end_pt (and
590       correspondingly for normpath)
591     - complete refactoring of the normpath class: normpaths now consist of
592       normsubpaths which themselves consist of normlines and normcurves This is
593       much more convenient for any routines working with normpaths.
594     - reversing of closed sub paths does not change the first point of the sub
595       path
596     - renamed: arclength -> arclen
597     - renamed: lentopar -> arclentoparam
598     - renamed: glue -> joined
599     - normpath now supports join, the in-place version of joined
600     - path and normpath method raise exception instead of returning None
601       when parameter is out of range
602     - the accuracy epsilon can now only be specified in normpath and normsubpath
603       constructor and no longer in arguments of path and normpath methods
604     - negative parameters are no longer supported in path and normpath methods
605     - path and normpath methods which accept parameter value param now
606       alternatively accept an arc length
607   - deco module:
608     - cycloid decorator
609     - smoothed decorator
610     - arrow heads are no longer stroked (as suggested by Magnus Lie Hetland)
611   - canvas:
612     - writeEPSfile deprecates writetofile
613     - internally, write methods are renamed in outputPS
614     - canvas constructor no longer accepts variable argument list but
615       expects a list of attrs as first argument (defaulting to []) and
616       a texrunner as second argument (defaulting to text.defaulttexrunner)
617     - set, draw, stroke and fill no longer return self, i.e., the canvas, but None
618   - bbox module:
619      - added inplace add (__iadd__), enlarge and transform methods
620      - callers use inplace add where possible now (yielding a considerable
621        speedup)
622     - "undefined" corners of bounding boxes are no longer supported which makes
623       the bounding box operations much more efficient.
624   - connnector module:
625     - renamed _xxx -> xxx_pt
626   - epsfile module:
627     - removed showbbox argument of epsfile class
628   - text module:
629     - default handling of texmessages as in the new attribute scheme
630     - multiple insert bug fixed
631     - made left, right, width, height, depth information available (x length
632       not taking into account box transformations)
633     - ignore tex message "Please type a command or say `\\end'"
634     - added textboxes that are sequentially filled (experimental)
635   - examples:
636     - mandel.py (contributed by Stephen Phillips)
637   - unit module:
638     - length comparision (David Beach)
639     - x-scale for TeX
640     - more unit tests
641   - mathtree module:
642     - switched to the new parser using pythons parser module
643   - data module:
644     - removed, it all lives in the graph.data module now, while before it
645       was splitted into two separate modules
646   - tex module:
647     - not imported by default anymore
648     - obsolete warning when importing this module
650 0.5.1 (2004/01/22):
651   - distribution:
652     - include missing c-files for optional extension modules
653   - prolog module:
654     - fix unpaired BeginProcSet/EndProcSet in font enconding
656 0.5 (2004/01/20):
657   - setup.py and distribution:
658     - allow customization of the extension modules built (via setup.cfg)
659     - disable building pykpathsea module by default
660     - more detailed description of install process in INSTALL
661     - provide more information and pointers to other files in README
662     - include example data files in distribution (suggested by Andrea Riciputi)
663     - force dvips to write ps files instead of printing them (suggested by Otto Tronarp)
664     - includ pyxfaq.pdf in distribution
665   - text module:
666     - improved is-readable test for lfs files and pyx.def file
667     - explicitly quit (La)TeX in cleantmp (helps when quitting with <Ctrl>C)
668     - showwaitfortex implemented following a suggestion by Fernando Perez
669       (waitfortex is increased to 60 seconds now)
670     - support of TeX extension --ipc for reading dvi results while TeX keeps running
671     - configurable font mapping files (via pyxrc or parameter of the texrunner constructor)
672     - markers to get access to positions within TeX expressions
673     - fix: allow for e-tex in texmessage.start (reported by Andrea Riciputi)
674     - fix: print warning at syntax errors in font mapping file and continue (cf. bug #795271)
675     - remove limitation on number of fonts in dvi file
676     - added native virtual font support
677     - dvicopy support not needed anymore (it is still available, but obsolete and
678       removed from the documentation)
679     - do not include too many glyphs in the eps file
680     - _xxx -> xxx_pt renaming
681   - dvifile module (NEW):
682     - separated from the text module
683     - dvifile class returns standard pyx canvas instances on readpage
684   - graph module:
685     - removed manualpart and partitioners mix keyword
686     - results of the splitting at "=" in graph.function were not stripped
687     - skip title=None in key (cf. bug #821284), properly align a single key entry
688     - another (the last?!) axis redesign: axispos -> class of its own
689     - some axispos name have changed slightly (zeroline -> zeropath etc.)
690     - tick/data-vmin/vmax removed
691     - pathaxis
692     - linkaxis
693     - minor enhancements in exponentionaltexter
694     - axes alongs paths including a set of examples
695     - mixing a partitioner and manual ticks by two distinct keyword arguments now
696     - _xxx -> xxx_pt renaming
697     - part -> parter renaming
698   - canvas module:
699     - stroke, fill, draw, set and insert do no longer accept variable length argument lists but
700       an attribute list as last argument
701     - stroke and fill now support trafos (TODO: documentation)
702     - uppercase version of a4, a3, ... paperformats
703   - config module:
704     - new module for loading PyX configuration information
705   - pyx module:
706     - automatically import main modules into pyx namespace as suggested by Fernando 
707       Perez.
708   - path module:
709     - check for sorting of parameter list passed to path.split method
710     - _xxx -> xxx_pt renaming
711   - deco module (NEW): 
712     - contains decoratedpath and decorators from canvas module
713     - all predefined decorators are instances now (deco.stroked is thus ok) and 
714       attributes have to be passed explicitely, e.g., deco.earrow.small(attrs=color.rgb.red) 
715       and deco.stroked([color.rgb.blue])
716   - style module (NEW):
717     - contains all line- and fillstyles which formerly had been defined in the canvas module
718     - dash now supports relative dash lengths (as suggested by Otto Tronarp)
719   - mathtree module:
720     - fixed incorrect handling of - (for instance -x**2 was not negative)
721   - attrlist module:
722     - contents have been moved to the (obsolete) tex module, which was the only user anyhow, and
723       the module itself was removed
724   - t1strip module:
725     - new fallback solution in pure python
726     - bugfix: pyxadapt.h needs to open files binary under Windows (reported by Gary Pajer)
727   - box module:
728     - _xxx -> xxx_pt renaming
729   - trafo module:
730     - _xxx -> xxx_pt renaming
732 0.4.1 (2003/09/17):
733   - canvas module:
734     - "in" to "inch" in paperformats
735   - text module:
736     - fix pyx.def hack occuring whenever \ProcessOptions* was used by a package
737   - pykpathsea module:
738     - implement different file formats for Python version of module
739   - t1strip module:
740     - python fallback solution should behave the same way as c extension module (closes SF bug #799182 reported
741       by Marcus Mendenhall)
742   - __init__.py:
743     - added "connector" to __all__
745 0.4 (2003/08/22):
746   - graph module:
747     - separate texter out of the axispainter
748     - axis/partitioner/texter/painter/axispos redesign & interfaces
749     - tick.text is renamed to tick.label
750     - ticks and labels are renamed to tickpos/tickdist and labelpos/labeldist in partitioning
751     - ticks can be used in the part to mix a partitioner with some manual ticks
752       -> manualpart and the mix technique is not needed anymore
753          (both things are still available and working, but they will be removed in the future)
754     - _ensurefrac is implemented inside the frac constructor now; initialization is possible by:
755       - a (enum, denom) tuple now (previously there were two arguments)
756       - a string (as before via _ensurefrac)
757       - exponential strings are allowed as well (e.g. "1e10" etc.)
758       - a float (precision is determined by floatprecision -- the number of decimal places)
759     - dense -> density
760     - axis.maxworse
761     - axis interface
762   - text module:
763     - reset() method for the texrunner
764     - automatic restart of a TeX instance with the same preamble (preamble changes are not possible)
765     - texmessage.loadfd for accepting font description loading
766     - don't bail out on width_index == 0, but mark character invalid instead
767     - dvicopy flag
768     - support for specials; pyxgraphics flag
769     - support psfonts.map: font names, font encodings
770     - bugfix \def\ProcessPyXBox -> \long\def\ProcessPyXBox
771     - improved lfs handling
772   - data module:
773     - full documentation via doc strings
774   - connector module:
775     - some preliminary version
776   - box module:
777     - multiple radii (up to two per point) and softnesses
778     - ensurecenter added --- do we always force the creation of a center?
779   - path module:
780     - lentopar methods added including some tests
781   - epsfile module:
782     - new parameter bbox allows to override the bounding box of the eps file
784   bugfixes:
785   - text module:
786     - derive TFMError and DVIError correctly from exceptions.Exception
787     - close files and pipes, if they are no longer used (thanks to Marcus Mendenhall)
788     - remove DeprecationWarning in Python 2.3 (thanks to Marcus Mendenhall)
789   - box module:
790     - correct rounding algorithm (Michael Schindler)
791   - graph module:
792     - refer to the graphs texrunner instead of the defaulttexrunner (cf. #728209)
793     - rounding towards zero bugfix in autolinpart
794     - log axis range rating bugfix
795   - mathtree module:
796     - addarg bugs (#738724)
797   - epsfile module:
798     - fix mixing up of height and width in scale calculation
799   - and various other fixer here and there
801 0.3.1 (2003/04/04):
802   - text module:
803     - fix bug in dvi rule code where width was height
804     - fix preamble attribute checking bug
805     - fix texmessage.load pattern search instead of pattern match bug
806     - renamed vbox to parbox (was done in 0.3 partially only)
807   - data module:
808     - allow for tuples in arguments of the data class
809     - convenience: exchanged order of named parameters in data.data
810   - graph module:
811     - convenience: allow for part=None in _axis (base of linaxis and logaxis)
812   - examples:
813     - added a latex example (requested)
814     - added a attributechange example (requested)
815     - added back the integral example (requested; prior PyX 0.3 it was part of the user manual)
816     - small change in vector example (allow for the access to the texrunner)
817     - examples included in source distribution
818   - canvas module:
819     - correct arrow template calculation for very short paths
821 0.3 (2003/03/31):
822   - examples
823     - new easy to use example generation (will hopefully lead to nice examples)
824   - unit box:
825     - new module for handling of convex polygons (taken out of the graph module)
826   - unit helper:
827     - new module containing a collection of helper functions (taken out of the graph module)
828     - moved the attrlist into helper -- as plain functions; attrlist becomes obsolete
829   - text module:
830     - new module: a new and preferable integration of TeX/LaTeX
831   - t1strip module:
832     - strip glyphs from pfa/pfb-fonts
833     - there is a C implementation taken from pdftex
834     - fallback solution via an external program (pfb2pfa)
835   - pykpathsea module:
836     - (partial) C binding to libkpathsea
837     - fallback solution via an external program (kpsewhich)
838   - graph module:
839     - removed some code duplication (various axis painters)
840     - use text module instead of the obsolete tex module
841     - allow for tailing zeros of automatic generated labels
842     - allow for missing data in bar graphs -> skipmissing parameter
843     - remove the support for variables given as keyword arguments in data constructor
844     - use context instead of extern for extern variables and functions
845     - graph keys; titles in data/function/etc.
846   - unit module:
847     - new classes for visual and width lengths, aliases for user length (u_pt = pt)
848     - all length classes have now by default a quantifier 1 (instead of 0), such that,
849       for instance, 5*unit.t_cm() == unit.t_cm(5)
850     - default_unit now has to be set via unit.set. For instance: unit.set(defaultunit="m").
851     - convert_to is now an internal function, which moreover does not longer accept tuples or lists
852   - bbox module:
853     - new class _bbox (the former bbox) which accepts points in the constructor. This is used
854       for internal purposes.
855     - the bbox constructor now accepts user lengths in the constructor.
856     - new methods height, width, top, bottom, left, right
857     - ll & ur ???, what about ul and lr -> ugly!
858     - enlarge (was enhance) now allows selective enlargement to the left, bottom, right and top
859     - output HiResBoundingBox
860     - never reduce bbox upon output
861   - epsfile module:
862     - new constructor signature, more in line with rest of PyX:
863       epsfile(x, y, filename, **additional_args)
864   - data module:
865     - removed additional column support in addcolumn; removed _addcolumn
866     - line reduction for datafile like the every parameter in gnuplot
867   - canvas module:
868     - new way of PS prolog generation that writes only necessary parts
869     - added support for patterns
870     - canvas.insert() now supports arguments
871     - bbox of canvas can be specified in writetofile command explicitely
872     - writetofile does not return self anymore
873     - arrow template now uses intersection with circle to get size right
874       (as per a suggestion by Michael Schindler)
875   - mathtree module:
876     - added abs function
877     - changed the handling of extern functions and all variables
878   - color module:
879     - gradient renamed to palette
880   - numerous bugfixes:
881     - problem with sizefile on windows (tex module)
882     - allow for strings in graphxy's width and height; allow for width only (graph module)
883     - disable rating for labelattrs equals None (graph module)
884     - defaultstyle selection, when a list of data is provided to the plot function (graph module)
885     - traverse when adding functions as arguments of operators (mathtree module)
886     - allow for extern functions in addcolumn (data module)
887     - just one common place for the version number
888     - fix incorrect exception name MathError (path module)
889     - prevent double return of intersections for closed sub paths
890     - ...
892 0.2 (2003/01/17):
893   - unit module:
894     - allow division of length by numbers
895   - trafo module:
896     - new transformation: slant
897     - renamed all trafo methods to use the participle (i.e translate->translated)
898     - the name of all trafo subclasses are verbs (i.e. translation->translate)
899   - graph module:
900     - mark class renamed to symbol
901     - (text-)box distance measurement
902     - moved axis partitioning to axis and axis painter
903     - automatic axis partitioning (now officially: general cleanup, distance measurement, documentation)
904     - splitaxis
905     - baraxis, baraxispainter, and bar style
906   - data module:
907     - previously named datafile module
908     - class "_datafile" renamed to class "data"
909     - class sectionfile added
910     - testsuite
911   - mathtree module:
912     - extern variables and functions (support in graph.function, graph.paramfunction and data.data)
913     - testsuite
914   - text module:
915     - deferred to Version 0.3
916     - running TeX "on the fly" is basically implemented
917   - numerous bugfixes:
918     - transformation bug (#624068, trafo module)
919     - canvas transformations (canvas module???)
920     - textbox alignment (graph module)
921     - return linewidth upon calculation with linewidths (unit module)
922     - allow column number variables with several digits
923     - ...
924   - british and american spellings (color module, graph module)
925   - small logo modifications
927 0.1 (2002/10/07):
928   - initial release