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