CHANGES.txt
author robin
Tue, 19 Nov 2013 13:50:34 +0000
branchpy33
changeset 3794 398ea04239b5
parent 3614 6d6349e762aa
child 4040 60080318e740
permissions -rw-r--r--
string module usage minimization
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
3054
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
     1
This is a summary of changes made to the reportlab source code for each release.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
     2
Please refer to subversion backlogs (using the release dates) for more details
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
     3
or for releases which we have not provide a higher level changes list for.
3086
1a4eaca7a26a Small text fixes to CHANGES.txt.
jonas
parents: 3085
diff changeset
     4
E.g. to retrieve the changes made between release 1.19 and release 1.20, type:
3054
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
     5
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
     6
  svn log -r {2004-11-25T18:00}:{2004-01-21T18:00}
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
     7
3086
1a4eaca7a26a Small text fixes to CHANGES.txt.
jonas
parents: 3085
diff changeset
     8
The contributors lists are in no order and apologies to those accidentally not
3054
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
     9
mentioned. If we missed you, please let us know!
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
    10
3610
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    11
#################################################################################
3612
1f92ba58b133 updated version
andy
parents: 3610
diff changeset
    12
#################### RELEASE 2.6  27/09/2012                    #################
3610
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    13
#################################################################################
3612
1f92ba58b133 updated version
andy
parents: 3610
diff changeset
    14
3610
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    15
This is a minor release focusing mainly on improved documentation.  There are a 
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    16
number of minor enhancements, and a larger number of previous-undocumented
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    17
enhancements which we have documented better.
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    18
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    19
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    20
###General changes
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    21
   * Manuals have been reformatted with more pleasing code snippets and tables of 
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    22
     contents, and reviewed and expanded
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    23
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    24
###Flowing documents (Platypus):
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    25
   * Added support for HTML-style list objects
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    26
   * Added flexible mechanism for drawing bullets
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    27
   * Allowed XPreformatted objects to use Asian line wrapping
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    28
   * Added an 'autoNextPageTemplate' attribute to PageTemplates.  For example you 
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    29
     can now set up a 'chapter first page template' which will always be followed
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    30
     by a 'continuation template' on the next page break, saving the programmer from
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    31
     having to issue control flow commands in the story.
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    32
   * added a TopPadder flowable, which will 'wrap' another Flowable and move it 
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    33
     to the bottom of the current page.  
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    34
   * More helpful error messages when large tables cannot be rendered
3614
6d6349e762aa added contributors
laurence
parents: 3612
diff changeset
    35
   * Documentation for images within text (test_032_images)
6d6349e762aa added contributors
laurence
parents: 3612
diff changeset
    36
   * Trailing dots for use on contents pages
3610
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    37
     
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    38
   
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    39
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    40
###Charts and graphics:
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    41
   * Support for UPCA bar codes
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    42
   * We now have a semi-intelligent system for labelling pie charts with 
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    43
     callout lines.  Thanks to James Martin-Collar, a maths student at Warwick 
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    44
     University, who did this as his summer internship.
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    45
   * Axes - added startOffset and endOffset properties; allowed for axis 
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    46
     background annotations.
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    47
   * Bar charts - allow more control of z Index (i.e. drawing order of axes and
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    48
     lines)
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    49
   * Pie charts - fixed bugs in 3d appearance
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    50
   * SVG output back end has seen some bugs fixed and now outputs resizeable SVG
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    51
   
3614
6d6349e762aa added contributors
laurence
parents: 3612
diff changeset
    52
###Contributors:
6d6349e762aa added contributors
laurence
parents: 3612
diff changeset
    53
   * Alex Buck
6d6349e762aa added contributors
laurence
parents: 3612
diff changeset
    54
   * Felix Labrecque <felixl@densi.com>
6d6349e762aa added contributors
laurence
parents: 3612
diff changeset
    55
   * Peter Johnson <johnson.peter@gmail.com>
6d6349e762aa added contributors
laurence
parents: 3612
diff changeset
    56
   * James Martin-Collar
6d6349e762aa added contributors
laurence
parents: 3612
diff changeset
    57
   * Guillaume Francois
3610
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    58
   
e415a9b24e80 added changes list
andy
parents: 3463
diff changeset
    59
   
3454
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    60
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    61
#################################################################################
3463
a57692215f7c CHANGES.txt: preparing (again) for 2.5
rgbecker
parents: 3454
diff changeset
    62
#################### RELEASE 2.5  at 18:00 GMT  01/Oct/2010     #################
3454
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    63
#################################################################################
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    64
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    65
Many new features have been added and numerous bugs have been fixed.
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    66
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    67
Thanks to everybody who has contributed to the open-source toolkit in
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    68
the run-up to the 2.5 release, whether by reporting bugs, sending patches,
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    69
or contributing to the reportlab-users mailing list.
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    70
Major contributors are credited in the user documentation.
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    71
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    72
   * Support for colour separated PDF output and other optimisations and
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    73
     features for high-quality printing, including enforcement of colour
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    74
     models for CMYK, RGB, and "spot colours"
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    75
   * Long table optimisations are now turned on by default.  Previously,
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    76
     documents with very long tables spanning many pages could take a long
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    77
     time to create because we considered the whole table to work out row
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    78
     and column sizes.  A patch was submitted some time ago to fix this
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    79
     controlled by a flag in the rl_config file, but this was set 'off'
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    80
     for compatibility.  Users are often not aware of this and we haven't
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    81
     found any real-world cases where the new layout technique works badly,
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    82
     so we are turning this behaviour on.
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    83
   * New support for QR barcodes - [try our demo!](https://www.reportlab.com/demos/qr/)
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    84
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    85
###PDF
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    86
   * Colour separation and other enhancements for high-end print
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    87
   * Python 2.7 support
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    88
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    89
###Charts
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    90
   * reportlab.graphics.charts.axes
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    91
       * ValueAxis
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    92
           * avoidBoundSpace - Space to allow above and below
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    93
           * abf_ignore_zero - Set to True to make the avoidBoundFrac calculations treat zero as non-special
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    94
           * keepTickLabelsInside - Ensure tick labels do not project beyond bounds of axis if true
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    95
       * NormalDateXValueAxis
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    96
           * specialTickClear - clear rather than delete close ticks when forced first/end dates
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    97
       * AdjYValueAxis
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    98
           * labelVOffset - add this to the labels
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
    99
   * reportlab.graphics.charts.barcharts
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   100
       * BarChart
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   101
           * categoryLabelBarSize - width to leave for a category label to go between categories
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   102
           * categoryLabelBarOrder - where any label bar should appear first/last
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   103
           * barRecord (advanced) - callable(bar,label=labelText,value=value,**kwds) to record bar information
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   104
   * reportlab.graphics.charts.legends
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   105
       * SubColProperty
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   106
           * dx - x offset from default position
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   107
           * dy - y offset from default position
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   108
       * Legend
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   109
           * swdx - x position adjustment for the swatch
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   110
           * swdy - y position adjustment for the swatch
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   111
   * reportlab.graphics.charts.piecharts
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   112
       * Pie
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   113
           * wedgeRecord (advanced) - callable(wedge,*args,**kwds)
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   114
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   115
   * reportlab.graphics.charts.utils
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   116
       * DrawTimeCollector - generic mechanism for collecting information about nodes at the time they are about to be drawn
85a663a7ffa8 trunk: prepare for version 2.5 tag
rgbecker
parents: 3313
diff changeset
   117
2982
32b005bb6879 reportlab: lastminute changes before 2.2 tagging
rgbecker
parents:
diff changeset
   118
#################################################################################
3312
8237e799475b Minor changes to README, CHANGES and LICENSE
damian
parents: 3288
diff changeset
   119
#################### RELEASE 2.4  at 18:00 GMT  20/Jan/2010     #################
3288
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   120
#################################################################################
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   121
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   122
PDF
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   123
    lots of improvements and verbosity to error messages and the way they are handled.
3313
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   124
    font size can now be specified in pixels
3288
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   125
    unicode file names are now accepted
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   126
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   127
Platypus
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   128
    canvas auto cropmarks
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   129
    added support for styles h4-h6
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   130
    Improved support for onDraw and SimpleIndex
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   131
    Add support for index tableStyle
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   132
    Added an alphabetic grouping indexing class
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   133
    Added support for multi-level and alphabetical indexes
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   134
    Added support for an unlimited number of TOC levels with default styles
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   135
    Index entries can now be clickable.
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   136
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   137
Graphics:
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   138
    Axes values can be reversible.
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   139
    Labels on the axes can now be drawn above or below the axes (hi or low).
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   140
    A per swatch callout is now allowed in the legend.
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   141
    A new anchroing mode for string 'numeric' that align numerical strings by their decimal place.
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   142
    Shapes have new attributes to specify if the shape should grow to take all canvas area (vertically or horizontally) or if the canvas should shrink to fit the shape size.
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   143
    color objects now have a clone method.
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   144
    colors module has a fade function that returns a list of different shades made up of one base colour.
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   145
    added in support for Overprint/Opacity & Separated colours
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   146
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   147
Bugs fixes
3313
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   148
    word counting in complex paragraphs has been fixed.
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   149
    SimpleIndex and TableOfContents bugs have been fixed.
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   150
    Fix for position of hyperlinks when crop marks are added.
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   151
    flowables.py: fix special case of doctemplate with no frames
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   152
    PDFFormXObject.format missing Resources bug patch from Scott Meyer
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   153
    KeepInFrame justification bug has been fixed.
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   154
    paragraph.py: fix linebreaking bug thanks to Roberto Alsina
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   155
    fix unicode/str issue bug found by Michael Egorov <michwill@gmail.com>
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   156
    YCategoryAxis makeTickLabels fix contributed by Mike Folwell <mjf@pearson.co.uk>
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   157
    pdfdoc.py: fix ro PDFDate contributed by Robert Alsina
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   158
    and others ..
3288
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   159
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   160
contributers
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   161
------------
3313
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   162
    PJACock's (<peter@maubp.freeserve.co.uk>)
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   163
    Hans Brand
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   164
    Ian Stevens
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   165
    Yoann Roman <yroman-reportlab@altalang.com>
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   166
    Randolph Bentson
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   167
    Volker Haas
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   168
    Simon King
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   169
    Henning Vonbargen
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   170
    Michael Egorov <michwill@gmail.com>
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   171
    Mike Folwell <mjf@pearson.co.uk>
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   172
    Robert Alsina
2d80e136a310 Minor changes to README, CHANGES and LICENSE
damian
parents: 3312
diff changeset
   173
    and more ...
3288
d361ad4e5bf6 user guide changes
meitham
parents: 3105
diff changeset
   174
#################################################################################
3105
35052ea93d1a Added Hans Brand and Ian Stevens to contributores list and set release date.
jonas
parents: 3091
diff changeset
   175
#################### RELEASE 2.3  at 18:00 GMT  04/Feb/2009     #################
3084
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   176
#################################################################################
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   177
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   178
PDF
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   179
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   180
  Encryption support (see encrypt parameter on Canvas and BaseDocTemplate constructor)
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   181
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   182
Platypus
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   183
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   184
  TableOfContents - Creates clickable tables of contents
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   185
  Variable border padding for paragraphs (using the borderPadding style attribute)
3091
5da6920cef32 Small addition to CHANGES.txt.
jonas
parents: 3086
diff changeset
   186
  New programming Flowable, docAssert, used to assert expressions on wrap time.
3084
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   187
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   188
Bug fixes
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   189
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   190
   Fixed old documentation and installation issues
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   191
   610 - Fixed Image anchoring code to match documentation
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   192
   704 - renderSVG groups problem
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   193
   706 - rl_codecs.py now compatible with WordAxe
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   194
   and others...
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   195
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   196
Contributors 
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   197
------------
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   198
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   199
Yoann Roman
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   200
Dinu Gherman
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   201
Dirk Holtwick
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   202
Marcel Tromp
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   203
Henning von Bargen
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   204
Paul Barrass
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   205
Adrian Klaver
3105
35052ea93d1a Added Hans Brand and Ian Stevens to contributores list and set release date.
jonas
parents: 3091
diff changeset
   206
Hans Brand
35052ea93d1a Added Hans Brand and Ian Stevens to contributores list and set release date.
jonas
parents: 3091
diff changeset
   207
Ian Stevens
3084
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   208
fa5bd7f45ce1 Updated CHANGES.txt with changes for 2.3.
jonas
parents: 3054
diff changeset
   209
#################################################################################
2982
32b005bb6879 reportlab: lastminute changes before 2.2 tagging
rgbecker
parents:
diff changeset
   210
#################### RELEASE 2.2  at 18:00 GMT  10/Sep/2008     #################
32b005bb6879 reportlab: lastminute changes before 2.2 tagging
rgbecker
parents:
diff changeset
   211
#################################################################################
3054
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   212
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   213
PDF
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   214
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   215
  pdfmetrics: Added registerFontFamily function
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   216
  Basic support for pdf document viewer preferences (e.g.: fullscreen).
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   217
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   218
Platypus
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   219
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   220
  Paragraph <img> tag support for inline images.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   221
  Paragraph autoleading support (helps with <img> tags).
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   222
  Platypus doctemplate programming support.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   223
  Support for tables with non-uniform row length.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   224
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   225
Graphics
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   226
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   227
  RGBA image support for suitable bitmap types.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   228
  LTO labelling barcode.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   229
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   230
And many bugfixes...
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   231
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   232
Contributors 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   233
------------
2982
32b005bb6879 reportlab: lastminute changes before 2.2 tagging
rgbecker
parents:
diff changeset
   234
3054
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   235
Matt Folwell
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   236
Jerome Alet
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   237
Harald Armin Massa
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   238
kevin@booksys.com
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   239
Sebastian Ware
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   240
Martin Tate
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   241
Wietse Jacobs
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   242
Christian Jacobs
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   243
Volker Haas
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   244
Dinu Gherman
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   245
Dirk Datzert
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   246
Yuan Hong
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   247
Ilpo Nyyss�nen
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   248
Thomas Heller
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   249
Gael Chardon
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   250
Alex Smishlajev
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   251
Martin Loewis
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   252
Dirk Holtwick
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   253
Philippe Makowskic
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   254
Ian Sparks
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   255
Albertas Agejevas
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   256
Gary Poster
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   257
Martin Zohlhuber
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   258
Francesco Pierfederici
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   259
michael@stroeder.com
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   260
Derik Barclay
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   261
Publio da Costa Melo 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   262
Jon Dyte
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   263
David Horkoff
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   264
picodello@yahoo.it
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   265
R�diger M�hl
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   266
Paul Winkler
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   267
Bernhard Herzog
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   268
Alex Martelli
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   269
Stuart Bishop
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   270
Gael Chardon
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   271
2982
32b005bb6879 reportlab: lastminute changes before 2.2 tagging
rgbecker
parents:
diff changeset
   272
#################################################################################
32b005bb6879 reportlab: lastminute changes before 2.2 tagging
rgbecker
parents:
diff changeset
   273
#################### RELEASE 2.1  at 15:00 GMT  24/May/2007     #################
32b005bb6879 reportlab: lastminute changes before 2.2 tagging
rgbecker
parents:
diff changeset
   274
#################################################################################
3054
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   275
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   276
Contributors 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   277
------------
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   278
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   279
Ilpo Nyyss�nen
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   280
Thomas Heller
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   281
Gael Chardon
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   282
Alex Smishlajev
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   283
Martin Loewis       
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   284
Dirk Holtwick
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   285
Philippe Makowskic
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   286
Dinu Gherman
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   287
Ian Sparks
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   288
 
2982
32b005bb6879 reportlab: lastminute changes before 2.2 tagging
rgbecker
parents:
diff changeset
   289
#################################################################################
32b005bb6879 reportlab: lastminute changes before 2.2 tagging
rgbecker
parents:
diff changeset
   290
#################### RELEASE 2.0  at 15:00 GMT  23/May/2006     #################
32b005bb6879 reportlab: lastminute changes before 2.2 tagging
rgbecker
parents:
diff changeset
   291
#################################################################################
3054
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   292
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   293
Contributions
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   294
-------------
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   295
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   296
Andre Reitz
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   297
Max M
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   298
Albertas Agejevas
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   299
T Blatter
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   300
Ron Peleg
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   301
Gary Poster
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   302
Steve Halasz
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   303
Andrew Mercer
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   304
Paul McNett
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   305
Chad Miller
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   306
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   307
Unicode support
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   308
---------------
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   309
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   310
This is the Big One, and the reason some apps may break. You must now pass in 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   311
text either in UTF-8 or as unicode string objects. The library will handle 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   312
everything to do with output encoding. There is more information on this below.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   313
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   314
Since this is the biggest change, we'll start by reviewing how it worked in the 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   315
past. In ReportLab 1.x, any string input you passed to our APIs was supposed to 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   316
be in the same encoding as the font you selected for output. If using the 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   317
default fonts in Acrobat Reader (Helvetica/Times/Courier), you would have 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   318
implicitly used WinAnsi encoding, which is almost exactly the same as Latin-1. 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   319
However, if using TrueType fonts, you would have been using UTF-8. For Asian 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   320
fonts, you had a wide choice of encodings but had to specify which one (e.g 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   321
Shift-JIS or EUC for Japanese). This state of affairs meant that you had to 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   322
make sure that every piece of text input was in the same encoding as the font 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   323
used to display it.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   324
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   325
With ReportLab 2, none of that necessary. Instead:
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   326
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   327
Here is what's different now:
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   328
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   329
Input text encoding is UTF-8 or Python Unicode strings
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   330
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   331
  Any text you pass to a canvas API (drawString etc.), Paragraph or other 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   332
  flowable constructor, into a table cell, or as an attribute of a graphic (e.g. 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   333
  chart.title.text), is supposed to be unicode. If you use a traditional Python 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   334
  string, it is assumed to be UTF-8. If you pass a Unicode object, we know it's 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   335
  unicode. 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   336
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   337
Font encodings
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   338
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   339
  Fonts still work in different ways, and the built-in ones will still use 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   340
  WinAnsi or MacRoman internally while TrueType will use UTF-8. However, the 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   341
  library hides this from you; it converts as it writes out the PDF file. As 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   342
  before, it's still your job to make sure the font you use has the characters 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   343
  you need, or you may get either a traceback or a visible error character. 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   344
  Asian CID fonts
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   345
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   346
  You no longer need to specify the encoding for the built-in Asian fonts, 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   347
  just the face name. ReportLab knows about the standard fonts in Adobe's Asian 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   348
  Language Packs. 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   349
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   350
Asian Truetype fonts
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   351
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   352
  The standard Truetype fonts differ slightly for Asian languages (e.g 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   353
  msmincho.ttc). These can now be read and used, albeit somewhat inefficiently. 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   354
  Asian word wrapping
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   355
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   356
  Previously we could display strings in Asian languages, but could not 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   357
  properly wrap paragraphs as there are no gaps between the words. We now have a 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   358
  basic word wrapping algorithm.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   359
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   360
unichar tag
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   361
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   362
  A convenience tag, <unichar/> has also been added. You can now do <unichar 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   363
  code="0xfc"/> or <unichar name='LATIN SMALL LETTER U WITH DIAERESIS'/> and get 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   364
  a lowercase u umlaut. Names should be those in the Unicode Character Database.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   365
  Accents, Greeks and symbols
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   366
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   367
  The correct way to refer to all non-ASCII characters is to use their 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   368
  unicode representation. This can be literal Unicode or UTF-8. Special symbols 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   369
  and Greek letters (collectively, "greeks") inserted in paragraphs using the 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   370
  greek tag (e.g. <greek>lambda</greek>) or using the entity references (e.g. 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   371
  &lambda;) are now processed in a different way than in version 1. Previously, 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   372
  these were always rendered using the Zapf Dingbats font. Now they are always 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   373
  output in the font you specified, unless that font does not support that 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   374
  character. If the font does not support the character, and the font you 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   375
  specified was an Adobe Type 1 font, Zapf Dingbats is used as a fallback. 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   376
  However, at present there is no fallback in the case of TTF fonts. Note that 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   377
  this means that documents that contain greeks and specify a TTF font may need 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   378
  changing to explicitly specify the font to use for the greek character, or you 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   379
  will see a black square in place of that character when you view your PDF 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   380
  output in Acrobat Reader.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   381
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   382
Other New Features
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   383
------------------
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   384
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   385
PDF
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   386
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   387
  Improved low-level annotation support for PDF "free text annotations"
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   388
    FreeTextAnnotation allows showing and hiding of an arbitrary PDF "form" 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   389
    (reusable chunk of PDF content) depending on whether the document is printed or 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   390
    viewed on-screen, or depending on whether the mouse is hovered over the 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   391
    content, etc.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   392
  TTC font collection files are now readable
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   393
    ReportLab now supports using TTF fonts packaged in .TTC files
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   394
  East Asian font support (CID and TTF)
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   395
    You no longer need to specify the encoding for the built-in Asian 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   396
    fonts, just the face name. ReportLab knows about the standard fonts in Adobe's 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   397
    Asian Language Packs. 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   398
  Native support for JPEG CMYK images
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   399
    ReportLab now takes advantage of PDF's native JPEG CMYK image support, 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   400
    so that JPEG CMYK images are no longer (lossily) converted to RGB format before 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   401
    including them in PDF. 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   402
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   403
Platypus
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   404
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   405
  Link support in paragraphs
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   406
    Platypus paragraphs can now contain link elements, which support both 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   407
    internal links to the same PDF document, links to other local PDF documents, 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   408
    and URL links to pages on the web. Some examples:
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   409
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   410
    Web links:
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   411
        <link href="http://www.reportlab.com/">ReportLab<link>
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   412
    Internal link to current PDF document:
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   413
        <link href="summary">ReportLab<link>
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   414
    External link to a PDF document on the local filesystem:
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   415
        <link href="pdf:c:/john/report.pdf">ReportLab<link>
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   416
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   417
  Improved wrapping support
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   418
    Support for wrapping arbitrary sequence of flowables around an image, 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   419
    using reportlab.platypus.flowables.ImageAndFlowables (similar to 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   420
    ParagraphAndImage).
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   421
  KeepInFrame
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   422
    Sometimes the length of a piece of text you'd like to include in a 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   423
    fixed piece of page "real estate" is not guaranteed to be constrained to a 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   424
    fixed maximum length. In these cases, KeepInFrame allows you to specify an 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   425
    appropriate action to take when the text is too long for the space allocated 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   426
    for it. In particular, it can shrink the text to fit, mask (truncate) 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   427
    overflowing text, allow the text to overflow into the rest of the document, or 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   428
    raise an error.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   429
  Improved convenience features for inserting unicode symbols and other 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   430
  characters
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   431
    <unichar/> lets you conveniently insert unicode characters using the 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   432
    standard long name or code point. Characters inserted with the <greek> tags 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   433
    (e.g. <greek>lambda</greek>) or corresponding entity references (e.g. &lambda;) 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   434
    support arbitrary fonts (rather than only Zapf Dingbats).
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   435
  Table spans and splitting improved
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   436
    Cell spanning in tables used to go wrong sometimes when the table split 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   437
    over a page. We believe this is improved, although there are so many table 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   438
    features that it's hard to define correct behaviour in all cases.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   439
  KeepWithNext improved
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   440
    Paragraph styles have long had an attribute keepWithNext, but this was 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   441
    buggy when set to True. We believe this is fixed now. keepWithNext is important 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   442
    for widows and orphans control; you typically set it to True on headings, to 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   443
    ensure at least one paragraph appears after the heading and that you don't get 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   444
    headings alone at the bottom of a column. 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   445
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   446
Graphics
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   447
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   448
  Barcodes
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   449
    The barcode package has been added to the standard reportlab 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   450
    toolkit distribution (it used to live separately in our contributions area). It 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   451
    has also seen fairly extensive reworking for production use in a recent 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   452
    project. These changes include adding support for the standard European EAN 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   453
    barcodes (EAN 8 and EAN13).
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   454
  Improvements to Legending
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   455
    Instead of manual placement, there is now a attachment point (N, 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   456
    S, E, W, etc.), so that the legend is always automatically positioned correctly 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   457
    relative to the chart. Swatches (the small sample squares of colour / pattern 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   458
    fill sometimes displayed in the legend) can now be automatically created from 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   459
    the graph data. Legends can now have automatically-computed totals (useful for 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   460
    financial applications).
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   461
  More and better ways to place piechart labels
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   462
    New smart algorithms for automatic pie chart label positioning 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   463
    have been added. You can now produce nice-looking labels without manual 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   464
    positioning even for awkward cases in big runs of charts.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   465
  Adjustable piechart slice ordering
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   466
    For example. pie charts with lots of small slices can be 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   467
    configured to alternate thin and thick slices to help the label placement 
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   468
    algorithm work better.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   469
  Improved spiderplots
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   470
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   471
Noteworthy bug fixes
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   472
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   473
  Fixes to TTF splitting (patch from Albertas Agejevas)
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   474
    This affected some documents using font subsetting
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   475
  Tables with spans improved splitting
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   476
    Splitting of tables across pages did not work correctly when the table had
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   477
    row/column spans
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   478
  Fix runtime error affecting keepWithNext
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   479
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   480
#####################################################
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   481
#################### Older releases #################
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   482
#####################################################
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   483
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   484
Please refer to subversion backlogs for a low level change list.
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   485
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   486
RELEASE 1.20 at 18:00 GMT  25/Nov/2004
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   487
RELEASE 1.19 at 18:00 GMT  21/Jan/2004
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   488
RELEASE 1.18 at 12:00 GMT  9/Jul/2003
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   489
RELEASE 1.17 at 16:00 GMT  3/Jan/2003
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   490
RELEASE 1.16 at 16:00 GMT  7/Nov/2002
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   491
RELEASE 1.15 at 14:00 GMT  9/Aug/2002
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   492
RELEASE 1.14 at 18:00 GMT 28/May/2002
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   493
RELEASE 1.13 at 15:00 GMT 27/March/2002
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   494
RELEASE 1.12 at 17:00 GMT 28/February/2002
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   495
RELEASE 1.11 at 14:00 GMT 12/December/2001
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   496
RELEASE 1.10 at 14:00 GMT 06/November/2001
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   497
RELEASE 1.09 at 14:00 BST 13/August/2001
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   498
RELEASE 1.08 at 12:00 BST 19/June/2001
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   499
RELEASE 1.07 at 11:54 BST 2001/05/02
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   500
RELEASE 1.06 at 14:00 BST 2001/03/30
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   501
RELEASE 1.03 on 2001/02/09
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   502
RELEASE 1.02 on 2000/12/11
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   503
RELEASE 1.01 on 2000/10/10
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   504
RELEASE 1.00 on 2000/07/20
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   505
RELEASE 0.95 on 2000/07/14
9055afab3268 Created higher level changes list and removed svn logs.
jonas
parents: 2982
diff changeset
   506
RELEASE 0.94 on 2000/06/20