(no commit message)
[taxeditor.git] / eu.etaxonomy.taxeditor.cdmlib / README.txt
1
2 Information on Apache FOP dependencies
3 =========================================
4
5 $Id$
6
7 The Apache Licenses can also be found here:
8 http://www.apache.org/licenses/
9
10
11 Normal Dependencies
12 ----------------------
13
14 - Apache Jakarta Commons IO
15
16 commons-io-*.jar
17 http://jakarta.apache.org/commons/io/
18 (I/O routines)
19
20 Apache License v2.0
21
22 - Apache Jakarta Commons Logging
23
24 commons-logging-*.jar
25 http://jakarta.apache.org/commons/logging/
26 (Logging adapter for various logging backends like JDK 1.4 logging or Log4J)
27
28 Apache License v2.0
29
30 - Apache Avalon Framework
31
32 avalon-framework-*.jar
33 http://excalibur.apache.org/framework/
34 (Avalon Framework, maintained by the Apache Excalibur project)
35
36 Apache License v2.0
37
38 - Apache XML Graphics Commons
39
40 xmlgraphics-commons-*.jar
41 http://xmlgraphics.apache.org/
42 (Common Library for Apache Batik and Apache FOP)
43
44 Apache License v2.0
45
46 - Apache Batik
47
48 batik-*.jar
49 http://xmlgraphics.apache.org/batik/
50 (SVG Implementation)
51
52 Apache License v2.0
53
54 - Apache XML Commons Externals (JAXP API)
55
56 xml-apis.jar
57 http://xml.apache.org/commons/components/external/
58 (the JAXP API, plus SAX and various W3C DOM Java bindings,
59 maintained in XML Commons Externals)
60
61 Apache License v2.0 (applies to the distribution)
62 SAX is in the public domain
63 http://www.saxproject.org/copying.html
64 W3C Software Notice and License (applies to the various DOM Java bindings)
65 W3C Document License (applies to the DOM documentation)
66 http://www.w3.org/Consortium/Legal/copyright-software
67 http://www.w3.org/Consortium/Legal/copyright-documents
68 http://www.w3.org/Consortium/Legal/
69
70 xml-apis-ext-*.jar
71 http://xml.apache.org/commons/components/external/
72 (additional DOM APIs from W3C, like SVG, SMIL and Simple API for CSS)
73
74 Apache License v2.0 (applies to the distribution)
75 W3C Software Notice and License (applies to the various DOM Java bindings)
76 W3C Document License (applies to the DOM documentation)
77 http://www.w3.org/Consortium/Legal/copyright-software
78 http://www.w3.org/Consortium/Legal/copyright-documents
79 http://www.w3.org/Consortium/Legal/
80
81 - Apache Xalan-J
82
83 xalan-*.jar and serializer-*.jar
84 http://xalan.apache.org
85 (JAXP-compliant XSLT and XPath implementation)
86
87 Apache License v2.0 (applies to Xalan-J)
88 Apache License v1.1 (applies to Apache BCEL and Apache REGEXP bundled in the JAR)
89 Historical Permission Notice and Disclaimer (applies to CUP Parser Generator)
90 http://www.opensource.org/licenses/historical.php
91 (see xalan.runtime.LICENSE.txt)
92
93
94 Special Dependencies
95 -----------------------
96
97 - Apache Xerces-J
98
99 xercesImpl-*.jar
100 http://xerces.apache.org
101 (JAXP-compliant XML parser and DOM Level 3 implementation)
102
103 Apache License v2.0
104
105 Xerces-J is not directly referenced by FOP or any of its dependencies.
106
107
108 A note on JAXP
109 -----------------------
110
111 Since Java 1.4, JAXP (Java API for XML Processing) is part of the
112 JRE/JDK. Every JVM includes the APIs and an implementation. However,
113 older JREs often contain implementations with bugs that are triggered
114 by code in Apache FOP and therefore need to be overridden. Now, since
115 JAXP is part of the class library, special precautions are necessary
116 to replace the original implementations. This is not done by simply
117 adding new JARs to the classpath as these classes would never be
118 loaded (due to Java's class loader hierarchy).
119
120 Replacing the default implementations involves understanding the
121 "Endorsed Standards Override Mechanism".
122 More information can be found here:
123 http://java.sun.com/j2se/1.4.2/docs/guide/standards/index.html
124
125 See also:
126 http://xml.apache.org/xalan-j/faq.html#faq-N100EF
127
128 Essentially, you have two different possibilities:
129 - add the replacement JARs in the jre/lib/endorsed directory of your JRE.
130 - Use the -Xbootclasspath/p: option when starting the JVM (may not be
131 available for every JVM).
132
133
134 Optional Dependencies
135 ------------------------
136
137 The following libraries are not bundled with FOP and must be installed manually.
138 Please make sure you've read the license of each package.
139
140 - JAI Image I/O Tools
141
142 https://jai-imageio.dev.java.net/
143 BSD license
144
145 Note: This is not the same as JAI! Only the ImageIO-compatible codecs
146 are packaged as "Image I/O Tools". The name may be misleading.
147
148 - JAI (Java Advanced Imaging API)
149
150 http://java.sun.com/products/java-media/jai
151 Java Research License and Java Distribution License (Check which one applies to you!)
152
153 Currently used for:
154 - Grayscale error diffusion dithering in the PCL Renderer
155
156 - JEuclid (MathML implementation, for the MathML extension)
157
158 http://jeuclid.sourceforge.net/
159 http://sourceforge.net/projects/jeuclid
160 Apache License v1.1
161
162
163
164 Additional development-time dependencies
165 -------------------------------------------
166
167 - Servlet API
168
169 servlet-*.jar
170 http://jakarta.apache.org/tomcat/
171 (Servlet API, javax.servlet)
172
173 Apache License v1.1
174
175 - Apache Ant
176
177 (not bundled, requires pre-installation)
178 http://ant.apache.org
179 (XML-based build system
180
181 Apache License V2.0
182
183 - JUnit
184
185 (not bundled, provided by Apache Ant or your IDE)
186 http://www.junit.org
187 Common Public License V1.0
188
189 - XMLUnit (optional)
190
191 (not bundled, to be added to your Apache Ant installation)
192 http://xmlunit.sourceforge.net/
193 BSD style license