README.md
1THE JCOMMON CLASS LIBRARY: Version 1.0.23
2=========================================
3
424 July 2014
5
6(C)opyright, 2000-2014, by Object Refinery Limited and Contributors.
7
8-----------------
91. INTRODUCTION
10-----------------
11JCommon is a free general purpose Java class library that is used in
12several projects including JFreeChart and Pentaho Reporting.
13
14*****
15SPECIAL NOTICE: BOTH JFREECHART AND PENTAHO REPORTING ARE MOVING TOWARDS
16ELIMINATING THEIR DEPENDENCY ON JCOMMON. AFTER THIS HAPPENS, JCOMMON WILL
17MOST LIKELY BE "RETIRED".
18*****
19
20JCommon is licensed, free of charge, under the terms of the GNU Lesser
21General Public Licence, version 2.1 or later. A copy of the licence is
22included in the download.
23
24The sources for this library are kept in a repo at GitHub:
25
26 https://github.com/jfree/jcommon
27
28If you have any comments, suggestions or bugs to report, please post a
29message in the JCommon forum.
30
31-----------------
322. CONTRIBUTORS
33-----------------
34Thanks to the following developers who have contributed code to this
35class library: Anthony Boulestreau, Jeremy Bowman, J. David
36Eisenberg, Paul English, Brian Fischer, Hans-Jurgen Greiner, Martin Hoeller,
37Ryan Hirrlinger, Bill Kelemen, Arik Levin, Achilleus Mantzios, Thomas Meier,
38Thomas Morgner, Krzysztof Paz, Andrzej Porebski, Nabuo Tamemasa, Mark Watson
39and Hari.
40
41---------------
423. WHAT'S NEW
43---------------
44Changes in each version are listed here:
45
461.0.23: (24-Jul-2014) Reorganised directories to align to Maven standard.
47 Updated pom file. Fixed Javadoc warnings for JDK 8.
48
491.0.22: (28-Feb-2014) Fix for endless loop in TextUtilities.createTextBlock().
50
511.0.21: (24-Oct-2013) Modified drawRotatedString() to call drawAlignedString()
52 when the rotation angle is 0.0. This provides benefits
53 downstream for JFreeChart, JFreeSVG and OrsonPDF.
54
551.0.20: (01-Sep-2013) Fixed TextFragment.draw() to respect TextAnchor argument.
56
571.0.19: (30-Aug-2013) Updated Licences.java so that complete licence text is
58 loaded on demand only (bug #1118).
59
601.0.18: (23-Sep-2012) Fixed PaintList.equals() bug, fixed line break issue in
61 TextUtilities;
62
631.0.17: (17-Oct-2011) Updated SerialUtilities to support serialisation of
64 Composite instances;
65
661.0.16: (17-Apr-2009) New release in conjunction with JFreeChart 1.0.13;
67
681.0.15: (19-Dec-2008) New ResourceBundleWrapper class to enable applets to
69 bypass codeBase lookup. Updated Maven specs.
70
711.0.14: (10-Sep-2008) Workaround added to PngEncoder, bug fix in ShapeList.
72
731.0.13: (05-Jun-2008) Bug fixes for TextBox and ShapeUtilities.
74
751.0.12: (02-Nov-2007) Made the resource-loading and classloader selection more
76 robust in cases where the jars were distributed over several
77 classloaders.
78
791.0.11: (19-Oct-2007) BugFix in the KeyedComboBoxModel causing
80 NullPointerExceptions on MacOS-X; Make sure that all resource-streams
81 that get opened also get safely closed in case of errors.
82
831.0.10: (21-May-2007) BugFix in the PackageSorter, Window positioning is now
84 multi-screen aware.
85
861.0.9 : (23-Mar-2007) Serialization fix in TextFragment.
87
881.0.8 : (11-Dec-2006) Minor bugfixes in the synchronization of the Booting code
89 and the FastStack.
90
911.0.7 : (03-Dec-2006) Cosmetic fixes for the logging of the PackageManager,
92 ObjectTable implementation allows faster cloning of its contents,
93 minor improvements to the GUI classes.
94
951.0.6 : (26-Sep-2006) BugFixes in the TextLayoutUtilities, SpreadSheetDate and
96 ResourceBundleSupport classes.
97
981.0.5 : (29-Jun-2006) BugFixes in the boot code (synchronization added) and
99 WaitingImageObserver (possible deadlock fixed). ObjectUtilities
100 did not handle all cases where a ClassLoader could be null.
101
1021.0.4 : (30-Apr-2006) Date- and NumberCellRenderer did not handle null-values
103 properly.
104
1051.0.3 : (17-Apr-2006) More improvements in the boot process for dependent
106 library hierarchies.
107
1081.0.1 : (10-Feb-2006) This release adds new boot capabilities and fixes
109 some bugs in the XML classes. This version is required for
110 JFreeReport and it is fully backward compatible with the 1.0.x
111 branch.
112
1131.0.0 : (14-Nov-2005) This is the official 1.0.0 release. All future
114 releases in the 1.0.x series will maintain backward compatibility
115 with the 1.0.0 API.
116
1171.0.0-rc1 : (01-Jun-2005) : Update to coincide with JFreeReport 0.8.5-5.
118 JavaDoc update and classloader handling changed.
119
1201.0.0-pre3 : (15-Apr-2005) : Some minor changes in the ResourceBundleSupport
121 to allow the explicit definition of a locale.
122
1231.0.0-pre2 : (04-Mar-2005) : Update to coincide with JFreeReport 0.8.5.
124 Separated the xml-support packages into an own jar file.
125 JFreeChart does not use these classes (except in experimental
126 non-release code). Therefore, JFreeChart needs both libs to
127 build, but only the jcommon.jar library to run.
128
129 The a more detailed list of changed please have a look at the
130 CHANGELOG.txt file.
131
1321.0.0-pre1 : (29-Nov-2004) : Update to coincide with JFreeChart 1.0.0-pre1.
133
1340.9.7 : (13-Oct-2004) Update to join JFreeReport with latest JFreeChart.
135
1360.9.6 : (10-Sep-2004) Update to coincide with JFreeChart 0.9.21.
137
1380.9.5 : (7-Jun-2004) Update to coincide with JFreeChart 0.9.20.
139
1400.9.4 : (28-May-2004) Update to coincide with JFreeChart 0.9.19.
141
1420.9.3 : (15-Apr-2004) Update to coincide with JFreeChart 0.9.18.
143
1440.9.2 : (26-Mar-2004) Update to coincide with JFreeChart 0.9.17.
145
1460.9.1 : (9-Jan-2004) Update to coincide with JFreeChart 0.9.16.
147
1480.9.0 : (28-Nov-2003) Update to coincide with JFreeChart 0.9.15.
149
1500.8.9 : (17-Nov-2003) Update to coincide with JFreeChart 0.9.14.
151
1520.8.8 : (26-Sep-2003) Update to coincide with JFreeChart 0.9.13.
153
1540.8.7 : (11-Sep-2003) Update to coincide with JFreeChart 0.9.12.
155
1560.8.6 : (8-Aug-2003) Update to coincide with JFreeChart 0.9.11.
157
1580.8.5 : (25-Jul-2003) Transferred some support classes from JFreeChart.
159
1600.8.3 : (16-Jun-2003) XML Parser: error locations are printed in the
161 parse exceptions to make debugging xml files easier.
162
1630.8.2a: (04-Jun-2003) xml parser: configuration interface modified.
164 + Bugfixes ...
165
1660.8.2 : (26-May-2003) xml parser class factory bug fix
167
1680.8.1 : (09-May-2003) Added support for the xml parser and imported
169 some base classes from the JFreeReport project.
170
1710.8.0 : (24-Apr-2003) Renamed all packages from com.jrefinery.*
172 to org.jfree.*.
173
1740.7.3 : (11-Apr-2003) Added serialization for SerialDate and
175 SpreadsheetDate classes. Added a SerialUtilities class.
176 Removed palette classes (now in JFreeChart). Added an
177 attribute to control whether or not a workaround is used for
178 drawing rotated text.
179
1800.7.2 : (6-Feb-2003) Bug fixes and Javadoc updates, incorporated an
181 Ant script to recompile the source files and generate the
182 Javadocs.
183
1840.7.1 : (18-Oct-2002) Bug fixes and Javadoc updates.
185
1860.7.0 : (4-Sep-2002) Moved package (com.jrefinery.data) to JFreeChart
187 project. Bug fixes and Javadoc updates.
188
1890.6.4 : (27-Jun-2002) Added logo to about box. Minor bug fixes (plus
190 JUnit tests) and code tidy up.
191
1920.6.3 : (14-Jun-2002) Bug fixes and Javadoc updates.
193
1940.6.2 : (7-Jun-2002) Added GanttSeriesCollection and supporting
195 classes. Added Polish resource bundle. Minor bug fixes.
196
1970.6.1 : (5-Apr-2002) Added MeterDataset interface and
198 DefaultMeterDataset class. Resource bundles for French, German
199 and Spanish languages. Reinstated the Week class. Minor bugfixes.
200
2010.6.0 : (22-Mar-2002) Changes to the API for the TimePeriod classes,
202 to improve methods that convert to java.util.Date. New
203 DefaultHighLowDataset class. New ResourceBundles for items
204 that require localisation.
205
2060.5.6 : (6-Mar-2002) Bug fix for combined datasets. Additional
207 methods in the TimePeriod class to handle different
208 timezones. Updated About box classes moved to new package
209 com.jrefinery.ui.about. Renamed Files.java -->
210 FileUtilities.java and SerialDates.java -->
211 SerialDateUtilities.java. Added new domain name
212 (http://www.object-refinery.com) in the source headers.
213
2140.5.5 : (15-Feb-2002) Fixed bugs in the constructors for the
215 TimePeriod subclasses. Reversed the order of the parameters
216 in the Month(int, int) constructor. Added methods to
217 Datasets.java to handle stacked data ranges. Fixed bug in
218 CombinedDataset.
219
2200.5.4 : (8-Feb-2002) New WindDataset interface and DefaultWindDataset
221 class. Bug fix for DefaultCategoryDataset.
222
2230.5.3 : (25-Jan-2002) Bug fixes, some minor API changes.
224
2250.5.2 : (10-Dec-2001) Added new combination datasets by Bill Kelemen.
226 Added contributors table to the AboutFrame class.
227
2280.5.1 : (27-Nov-2001) AboutPanel and AboutFrame classes added.
229
2300.5.0 : (21-Nov-2001) PieDataset and DefaultPieDataset classes added.
231
2320.4.2 : (16-Nov-2001) New classes in the com.jrefinery.data.* package,
233 plus some new JUnit test cases.