| 1 |
Apache XML Commons Resolver for Debian
|
| 2 |
--------------------------------------
|
| 3 |
|
| 4 |
- The JAR is named xml-commons-resolver-*.jar in /usr/share/java. Most
|
| 5 |
applications that use the resolver library expect the JAR name to be simply
|
| 6 |
resolver.jar in their build files.
|
| 7 |
|
| 8 |
- Two files are missing in the Debian package compared to upstream's binary
|
| 9 |
distribution. I don't know where upstream got them from, the strings
|
| 10 |
"WhichFactory" and "WhichJar" don't appear in the source code at all:
|
| 11 |
|
| 12 |
org.apache.env.WhichFactory.properties
|
| 13 |
org.apache.env.WhichJar.properties
|
| 14 |
|
| 15 |
- The Javadoc API documentation is not re-created during the build process
|
| 16 |
because there are no tools for this in the Debian main section. The
|
| 17 |
pre-built version from the distribution archive is used instead.
|
| 18 |
|
| 19 |
- This package installs a CatalogManager.properties file in the
|
| 20 |
/etc/xml directory. Among other things, the CatalogManager.properties
|
| 21 |
file tells the resolver where to find XML catalog files to use.
|
| 22 |
Debian uses a single master catalog file -- /etc/xml/catalog -- so the
|
| 23 |
CatalogManager.properties that this package installs points to that file.
|
| 24 |
|
| 25 |
In order for the resolver to be able to find and use the
|
| 26 |
CatalogManager.properties files, you need to include the
|
| 27 |
*directory* that contains it -- the /etc/xml directory -- in your Java
|
| 28 |
classpath, either by specifying it on the Java command-line or via
|
| 29 |
the CLASSPATH environment variable:
|
| 30 |
|
| 31 |
export CLASSPATH=/etc/xml:$CLASSPATH
|
| 32 |
|
| 33 |
-- Stefan Gybas <sgybas@debian.org>,
|
| 34 |
Arnaud Vandyck <avdyk@debian.org>
|