1$Id: README 1885379 2021-01-12 09:32:59Z ssteiner $
2
3==============================================================================
4  APACHE XML GRAPHICS COMMONS  -  README
5==============================================================================
6
7Contents of this file:
8 - What is Apache XML Graphics Commons?
9 - Where to get help?
10 - How do I build Apache XML Graphics Commons?
11 - Legal information
12 - Release Notes
13
14==============================================================================
15
16
17What is Apache XML Graphics Commons?
18---------------------------------------
19
20It is a place where the Apache Batik and Apache FOP share commonly used
21components. Many components in here are also usable and useful stand-alone.
22
23Documentation
24---------------------
25
26The documentation can be found under:
27http://xmlgraphics.apache.org/commons/
28
29Where to get help?
30---------------------
31
32Please subscribe to the general@xmlgraphics.apache.org mailing list by sending
33an empty mail to general-subscribe@xmlgraphics.apache.org. All you questions
34about XML Graphics Commons will be answered there.
35
36Please report bugs to JIRA at http://issues.apache.org/jira/ (project
37XMLGraphicsCommons).
38
39
40How do I build Apache XML Graphics Commons?
41----------------------------------------------
42
43If you've downloaded a binary distribution of Apache FOP or Apache Batik,
44you don't need to build XML Graphics Commons. It is distributed with these
45two products.
46
47Otherwise, install Apache Ant (http://ant.apache.org) and run "ant" from the
48command-line in the directory where you find "build.xml".
49
50Legal information
51--------------------
52
53Apache XML Graphics Commons is published under the Apache License
54version 2.0. For the license text, please see the following files:
55- LICENSE
56- NOTICE
57
58Legal information on libraries used by Apache XML Graphics Commons, i.e.
59its dependencies, can be found in the "lib/README.txt" file.
60
61Apache XML Graphics Commons contains unmodified copies of the Adobe Glyph
62List and the ITC Zapf Dingbats Glyph List, available from:
63http://www.adobe.com/devnet/opentype/archives/glyph.html
64
65License labeling (according to http://www.apache.org/legal/3party.html):
66- Multi-Licensed
67- Source Available
68- No Reciprocity Required
69
70==============================================================================
71  KNOWN ISSUES
72==============================================================================
73
74- PostScript output: When TexturePaint is used with PSGraphics2D, the output
75  violates the DSC specification. Extracting single pages from a multi-page
76  PostScript file can result in errors.
77
78==============================================================================
79  RELEASE NOTES
80==============================================================================
81
82For more detailed info about the changes, please see:
83http://xmlgraphics.apache.org/commons/changes.html
84
85Version 2.6
86--------------
87
88Minor release to be used with FOP 2.6
89
90Version 2.4
91--------------
92
93Minor release to be used with FOP 2.4
94
95Version 2.3
96--------------
97
98Minor release to be used with FOP 2.3
99
100Version 2.2
101--------------
102
103* Transition from Ant to Maven Build Process
104
105Minor release to be used with FOP 2.2
106
107Version 2.1
108--------------
109
110Minor release to be used with FOP 2.1
111
112Version 2.0.1
113--------------
114
115Minor release to be used with FOP 2.0
116
117Version 2.0
118--------------
119
120The main new feature is the introduction of a URI resolution framework that
121makes it easier to control resource access in a cloud environment. Because of
122changes to the API, the version number has been bumped to 2.0.
123
124This release also contains a number of bug fixes.
125
126Version 1.5
127--------------
128
129This release of Apache XML Graphics Commons  primarily addresses bug fixes
130and also adds a number of new features.
131
132Version 1.4
133-----------
134
135This release adds the option to generate smaller PostScript files,
136support for the AdobeStandardCyrillic encoding, RefinedImageFlavor,
137TexturePaint support for PSGraphics2D (PostScript tiling patterns),
138improvements to the XMP framework, optimization for PostScript state
139handling in (E)PSDocumentGraphics2D, and more. In addition it contains
140a number of bug fixes.
141
142Version 1.3.1
143--------------
144
145This release is mostly a bugfix release for the image loading framework that
146has been introduced in version 1.3.
147
148Version 1.3
149--------------
150
151The most important addition in this release is an image loading framework
152which supports all sorts of different image formats (bitmap and vector) and
153is highly extensible.
154Besides that there were a larger number of smaller additions and bugfixes.
155Support for Java 1.3 has been dropped. Java 1.4 or later is required now.
156
157Version 1.2
158--------------
159
160This release mainly adds support for CMYK and GRAY color spaces for PSGenerator.
161
162Version 1.1
163--------------
164
165This release adds an XMP metadata framework and brings improvements for the
166ImageWriter package plus some minor fixes mainly in the PostScript area.
167
168Version 1.0
169--------------
170
171This is the first release of Apache XML Graphics Commons. There are currently
172no known issues with the code.
173