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